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UKo Shoia^ RMtf Ihlm Book 

The manual contains both introductory and reference 
*nfor«ation. Each chapter is divided into description «^-^d 
coMands The description section introduces the concepts of 
the system. The coMand section describes the commands in 
alphabetical order. 

Th*s manual contains information not published in previous 
manuals. In addition, the presentation of the material he" 
been mproved for better user understanding. 



Chapter ^mmmt f 

^h's manual is divided into seven chapters: 

Chapter 1 Introduction 

Chapter 2 Monitors 

Chapter 3 Diagnostic Runtime Services 

Chapter 4 UPQAT Utility 

Chapter 5 - PATCH Utility 

Chapter 6 SETUP Utility 

Chapter 7 XTECO Utility 

Chapter 8 Batch Control 

Each chapter has several examples of actual usage. 

The appendixes provide reference Information, as follOMS; 

Appendix A Glossary 

Append I x B Command Summary 

Appendix C Devices Supported 

Appendix D Component Names 

Appendix E Building XXQP 

Appendix F User Tips 

Append 'x G Error Messages 



C onvanttona 

There are two conventions used In presenting command formats 
throughout this manual, rirst, a field, or item. In a 
command that is a variable (such as a file name} Is denoted 
by the jse of lower case characters. Fields shown In upper 
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C8S€ characters must be entered exactly as shown. Second, 
oot onal fields in a coMniand are enclosed in square ("[]") 
brackets. XXOP Xn commands require only a few characters to 
un'quely 'dentlfy a command. The required characters are 
shown n upper case and the optional characters are shown in 
lower case. 

^or example, consider the following: 

R f ilnam [addrl XXDP Sn 

Run filnam [addr] XXDP Xn 

In th« SM monitor, you type "R" followed by a file name. In 
th€ XM monitor, you can type "R". 'RU". or "RUN'* followed by 
a file name. The address is optional, as indicated by the 
square brackets. 



CMpmriMfi of tha XXDP Vl.l and V2 Nanitors 

The XXDP V2 monitor has the same functionality as the Vl.l 
mon»tor and the following enhancements: 

o Improved console handler to provide video terminal 
support. 

o Improved operator Interface so that it Is simpler 
to use. 

o ^mory mapping capability, so that the DRS can be 
moved to memory above 28k words and provide space 
for large diagnostics. 

o Reporting capability, which allows data and error 
reports and end of pass information to be saved on 
the system media. 



Co«potibility 

XXDP V2 required development of a modified Supervisor. All 
d' agnostics that are now compatible with the old DRS will be 
compatible with the new DRS providing they do not manipulate 
the MMU or wr*te Intc the V2 DRS and monitor area. 
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f%jftth%r lafoTMtion 

Th« following manuals provide additional information: 
XXOP V2 File Structure. AC-UOSSA-MC 
XXOP V2 Driver Programmer Guide, AC U036A-nC 



This manual was prepared by and is maintained by Low End 
O*agnostlc Engineering. Comments and suggestions are 
welcome. Internal users (DEC emoloyees) should refer to the 
DEC phone directory lasting for D* agnostic Engineering. 
PDP-11 Systems. External users should contact their sales 
representative. 
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CHAPTER 1 
INTRODUCTION 

XXDP V2 s the diagnostic operating system for POP/LSI-11 
systems. 

1.1 Coflponmnta 

The XXDP system consists of the following major components: 
O Monitor 

o Diagnostic run time services 

o Utility programs 

o Loadable device drivers 

These four components work together to accomplish the system 
functionality. 

1.2 Nonitor 

The Monitor is the hi chest level software and forms the core 
of the system. All or the other components require monitor 
support for their operation. The monitor program provides: 

o Load and execution 



o Console terminal services 
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o Batch control 

o F'le services for the system medium 

The system inedlum is the storaoe medium on the device from 
lihlch the monitor is loaded. Rll other components use the 
terminal services for operator communications and the file 
services for accessing files on the system media. 



l.S Oiapio^tic RuntiM SarvicM 

The Diagnostic Runtime Services (DRS) are an extension of 
the monitor; they provide non-diagnost ic function support 
for certatn types of diagnostic programs. These diaonostics 
are cowiionly referred to as Mparvigor compatible. Among 
the funct'ons that the DRS provide are: 

o Standard operator interface 

o Error message formatting 

o Control of diagnostic operation 



1.4 Utility Pregrama 

The Utility Programs use the monitor for typing and 
receiving messaoes and for loading read/write device drivers 
required for file operations. 

The fol lowing utility programs are available: 

o UPDAT 

o PATCH 

o SETUP 

o XTECO 

o DXCL 

Documentation for the first four utility proorams is 
provided in this manual. Documentation for DXCL is 
available separately. 
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1.5 Loi<ifcl# Otvic€ Drivers 

TK€ Loadable device drivers are the device handlers used by 
the various utility programs to access storage media and I/O 
devices. The drivers are resident on the system storage 
media and loaded into memory as required. 



1«6 Convantiona 

Two kinds of conventions are used in XXOP, namely: terminal 
interface conventions and file conventions. The following 
sections describe these two kinds of conventions. 



1.6.1 Terminal Intarfmea Convantiona 

The console terminal is supported as part of the XXOP 
monitor. The console terminal driver is a simple, 
flag-driven handler. Flag-driven means that no interrupts 
are used and thus unsolicited interrupts do not interfere 
with diagnostic programs. 

The driver makes no distinction between upper and lower case 
characters. All printing characters are supported, but some 
characters have special significance in specific situations. 
The table below lists these special characters. This table 
briefly describes the function of the characters. Oetailed 
descriptions and examples are left for later sections of 
this manual. 

Char Use 

delimit a device specification (e.g.« DUO:) 
; start comment line in a batch control file 

beginning of a three character extension in 

In a file name 
? "wildcard" character in file name 

♦ "wildcard" specif icationin file name 

' separator between input and output 

specifications in a command 
< equivalent to 

/ command switch 

In addition, the terminal driver supports the four control 
characters listed in the table below. Control characters 
depicted with an ^ '-arrow are entered by pressing the "CTRL" 
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kty and tH« dts!gnat€d letter at the same tline. 

Char Use 

tC stop current activity and return 

control to program (testable in batch 
control file) 
stop current activity and return 

control to program (not testable in batch 
control file) 
delete entire line of input so new 
line can be typed 
tS inhibit typing (XOFF) 

resume typing (XON) 
*X resume activity after WAIT command in 

batch control file 



1.6.2 FiU ComwtioM 

XXQP files are specified by a name and extension. The 
format of a file specification Is: 

file-name [.ext] 

^He-name can be from one to six characters in length and 
th€ extension (ext) can be from one to three characters In 
length. The name and extension are separated by a dot (.). 
Only alphanumeric characters (A-Z 0*9} can be used and 
spaces may not be Imbedded^ Sample file names: 

UPDAT.BIN 
DRSSM.SYS 
TEST.l 
XHONCO.LIB 

XXDP alloMS the use of the wildcard characters and 
*n file specifications. The "?" Is used as a substitute for 
a character and Is used as a substitute for a string of 
characters In a file specification. 

^or example. If you want a list of all the files with the 

.CCC' extension on a medium, you can give the specification 
'•.CCC . 

jther examples of the M*ldcard characters are: 

/HON??.lZB all files whose name starts with 
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XWONCO.??? 



the characters "XHON" and ends 

Mith any tMO Other valid 

characters (or nulls) and have 
the extension "LIB" 



XHON*. LIB saM effect as above 

XtfONCO.* all files with the name 

and any extension 



"XMONCO" 



sane effect as above 



1.4.2.1 CxtwwidM 

SoMc extens'ons are used to identify particular file types, 
^or cxaMple. batch control files have ".CCC" extensions. 
BeloM 's a table of extensions that have particular 
•esn'ngs. 

BIN Executable proQram f tic that may 

not be run or loaded In batch control 
operat lon 

BIC Executable program file that may 

be run or loaded In batch control 
operation 

S'S System file 

CCC Batch control file 

OB. DEC/Xll object module 

.IB L'brary file 

V 'ext ru 

BA»^ r£ZO backup ^Ue 



CHAPTER i 
THE MONITORS 



Th€ XXDP V2 operating systcn consists of ti<0 monitors. Th« 
XH monitor and the Sn monitor. The XM monitor is used when 
• memory manMement unit exists on the svstem and passes the 
requirements for booting this monitor. The SH monitor is 
booted by a chain file user request or in cases when the Xn 
monitor cannot be booted. The SM monitor emulates the 
caoabilitles of the XXDP VI monitor, Mtth some restrictions 



This chapter describes the monitor and then list the 
commands for each monitor. 



2.1 DMeription 

The V2 monitor is simple to boot, configure and use. The 
monitor is relocatable and thus supports the loading of 
current diagnostic products. It self*starts if all but a 
I.SKm reserved section Is corrupted during diagnostic 
operations. The monitor does not rely on hardware 
"nterrupts for Its operation In order to minimize dependency 
on hardware functionality and Impact of malfunctioning 
equipment. 



2.1.1 Nwiitor Sim and Ca^panamta 

load t'me the XXDP monitor is about 8K words In size and 
cons'sts of three major sections: secondary bootstrap. 
>'t'BlIzatIon code and the runtime monitor code. The 
secondary bootstrap Is loaded Into memory at boot time and 
loads the remainder of the monitor Into memory. The 
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>*t *«l*:»t COdt 9atK«rs certain systcii lofomiatloo and 
reloc«t«a th« runtint iiooltor. Th« njntint monitor is the 
coot tHat *S uMd to COrry out tK« various operator 
^^ct'ons. The start up proctss is described io more deta 1 
beloM. 

^he r^t*M iionitor consists o^ ^ive sections: 

o read-Mrlte device driver loads programs from the 
system medium and reads batch control files. 

o console terminal driver 

o monitor services handler processes requests for 

mon'tor services that are made by utility programs 

v'a the EHT Instruction. 

o operator interface handler processes operator 
commands from the console terminal. 

o batch control handler — processes batch files from 
the system medium. 

'^he runtime monitor *s approximately MOrdS in size. 
S*nce older d'agnost'c programs expect the monitor size to 
be :.5<. the mon'tor s lower .5K may be overwritten by a 
o' agnostic program and then later restored by the monitor. 



2.1.2 DiavMtic UmirmmU 

Memory and CPU diagnostics that are compatible with XXDP VI 
are coo^tlble with XXDP V2. They must maintain the 
"ntegr'ty of the 1.5 area at the top of the first 28 ku 
o^ memory. XXDP XH auto-boots *f the monitor Is destroyed. 
bJt all cond*t*ons may not be fully restored. 

'^he ^oUomlng 's a list of CPU's presently known to have the 

support required to be supportable by the XXDP XM 
mon'tor: 

11/23 s. Micro PDP-11, 11/73 

jn'bJS: - 11/24. 11/34. 11/35. 11/40. 11/44, 
11/45. ll/"^0. 11/84 
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ry nanMtMnt !• r«Qu!r«d for XXQP XM inonitor to 
oo€rst€. I* tH«r« is • failure 'n the HhU, the system 
reports the error end boots the XXQP SM inonitor. 

Any additional data helpful for determlnlno the cause of the 
problem fS also reported, but XXOP Is not intended as a 
O'agnost'c so It does not perform rigorous error 
detect on/ reporting. 



2.1.4 Oi 



ic 



icti 



DIaonostlcs that Interfere Mith th« monitor EHT and TRAP 
vector area can not use system calls. Hany SYSHAC 
diagnostics do this as normal operation when they load and 
also Mhen they run. 



Restriction: 
Cvplmnatlon: 



The XXOP SH mon'tor requires minimum 16K Mords of 



The boot section requires 8kM of memory plus 
room for the monitor also any diagnostics that 
require the POP-11 Diagnostic Supervisor will 
require this minimum environment. 



Restriction: The Integrity of the l.SWw base monitor or root 
at the top of the first 2Bkm memory must be 
maintained, ^allure to do so mUI require a manual 
reboot for contiuned system operations. 

Explanation: Th's root required to restore the monitor. 



2.1.5 XMT Sfwtm Start-i^ 

follow these steps to start up the system: 

1. Hslt the processor (after making sure thst any 
operating software has been 'gracefully" shut 
down), nount/load your XXQP medium. If you are 
worir'ng on a system that has unknown hardware 
problems, make sure the load device Is write 
d'sabled. 
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2, Rc-cnsblc and boot the processor. 

3. UH^n the Aonltor has successfully loaded, it 

dentifies itself and gives the drive number from 
Mhich it Mas booted (mult i drive devices only) and 
the memory size An example is: 

XXOP-Sri SMALL MONITOR VERSION 2 
BOOTED FROM OYO? 
24 KU OF MEMORY 
NON-UNIBUS SYSTEM 

The message in the example above is printed after 
booting from an RX02 with the XXOP SM monitor on a 
system Mith 24K Mords of memory, using drive 0. 
The monitor then relocates the runtime monitor code 
to the top of available memory (up to 28K Mords in 
this case, but It could load into extended memory 
if the XM monitor were booted) and transfers 
control to this code. 

When these steps have been successfully completed, the 
monitor types a dot (.) to prompt for commands. The 
commands ror the XXDP SM and XM monitors are given later in 
th*s chapter. 



2.1.6 XXDP Start-up P roc i mm 

Uhen you boot the load device, the first physical block of 
data on the medium is loaded into the first 256(10) Mords of 
Mmory. This data is the secondary bootstrap. Control is 
passed to it from the hardware, or primary, bootstrap. The 
secondary bootstrap reads the remainder of the monitor from 
the load medium into memory. Uhen the load is complete, the 
secondary bootstrap passes control to the initialization 
code and the boot process is complete. If a detectable 
error occurs durina the secondary bootstrap Operation^ the 
processor Mill halt. 

the boot process Is successful, the boot performs the 

following functions: 

:. Reads and executes the "BOOT.CCC" chain file and 
sets up cond't'ons from this file (either SM or 

aUIET). 
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2. Sizes Memory (up to 124K words) and sizes for the 
presence of standard line or prografmnable clocks 
(KU-llL and KU-llP), processor type, and interrupt 
integrity. 

3. Verifies hardcore requireiients 

Reports any errors found 

Inform user if booting SM monitor instead 
of tn nonttor (if not In QUIET mode). 



4. Loads and locates the monitor to the top of memory. 
XM is normally loaded. IF the XM monitor cannot be 
loaded or if the BOOT.CCC file instructs otherwise, 
the SM monitor is loaded. 

5. Identifies the monitor if not in QUIET mode. 

6. Starts the monitor. 

The BOOr.CCC file is only executable by the boot section of 
code and only accepts either the SM or QUIET commands. The 
QUIET command puts the XXDP Xh monitor into QUIET mode and 
starts the SYSTEM. CCC chain file. Only one of these 
commands can be used. 

If the system is too small for the XXDP XM monitor of if the 
memory management unit is not operating properly, the XXDP 
SM monitor starts. Since the XXDP SM monitor is not capable 
of QUIET mode operation, the QUIET command is ignored by 
this monitor. 

The XXDP monitor assumes you are operating with US* type (60 
Hz) power. If you are using European-type (50 Hz) power, 
you must modify the monitor. Location 370 in XXDPXH.SYS 
contains an indicator or power type. 0 for 60 Hz and 
non-zero for 50 Hz. Chapter 4 on UPDAT explains how to 
modify files, but a brief example is given here. 



UPDAT 
LOAD DfOrXXDPSM.Si'S 
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HOD 1000 

001000 000000 1 

LOAD 0Y0:XX0PSri.NEU 

OUHP DYO:XXOP??.NEU 

un^ierliottd Dortlon in th« above exa«iple is typed by 
XXOP. Th« user has modified the iionitor and saved it on 
tHa floppy diskette lo drive 0, giving tH« iionitor a new 
extension to prevent deletino tha old ■K>nitor. The CREATE 
coMftand can be used to make the device bootable. 



2.2 sn NaiiiUr Ce— n<a 

^His sections describes the SH monitor coMands. Note that 
th« "F'ILL coMand is no longer supported under the XXOP SM 
■ior»Itor. 

''he coMands for the XXDP SH monitor are: 

R run a program 

L load a program 

S start a program 

C run a batch jot (chain) 

D list directory of load medium 

E enable alternative drive for system device 

H type help information 

TEST run a batch file called SYSTEM. CCC 

Some commands have optional switches, which consist of a 
s'ngle character preceeded by a Switches are used to 

mod the command function. 
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2.2.1 Chain Co—fi< 

The cHain coMnand is used to initiate execution of a batcK, 
or chain, file. The file must be on the system medium and 
must have a .CCC extension. Some batch operations accept 
switches. 

The format of the chain command is: 

C f ;inam[ /switches 1 

Chapter B of this manual describes batch control in detail, 
rxmn^le: 

C XTEST/RX 

Th's command initiates execution of the file XTh'ST.CCC. In 
thJs chain file you can test for the RX condition and 
execute different sections depending on this switch. 



I<2 



SEQ 0023 
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2.2.2 Directory C o— >n d 

The d rectory coMnand is used to obtain a list of all the 
files on the system medium. This list contains five items 
of information: the entry number, the complete file 
specification (name and extension), the date the file Nas 
created, the length of the file in 256 (decimal) word blocks 
and the number of the first block in the f»le. Most files 
are "linked"; that is, their blocks are not in order on the 
medium. A few files are contiguous; that is* their blocks 
are in order on the medium. Contiguous files are noted in 
the directory by a "C" following the date. 

The directory utility (DIR. SYS) and the read/write device 
driver for tne system medium type must be on the system 
medium In order for the directory command to work. If one 
of these files is not on the medium, the monitor types an 
error message. 

The format of the directory command is: 



There are two optional switches for the directory command. 
The VL" switch causes the directory to be printed on a line 
printer rather than the console terminal. The "/F" switch 
causes the directory to printed in a short form, which only 
gives the entry number and file name. 



D[/L][/F] 



Directory Long Form 



ENTRY* FILNAM.EXT 



DATE 



LENGTH START REVISION 



1 
2 
3 



XXDPSM.SYS 
DU .SYS 
DY .SYS 



02-JUN-79 
02-JWJ-79 
02-AUG-79 



12 

5 

6 



000100 A.O 
000120 B.l 
000066 A. 2 



Directory Short Form 



1 XXDPSM.SYS 

2 DU .SYS 

3 DY .SYS 
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2.2.1 ENMlE 

The enable coMand is used to desionate a different drive as 
the system device. For example, if you booted the system 
from drive 0 of an RX02 and later wanted the monitor to use 
drive 1 as the system device (that is, as the default 
device), you could do this without re booting the monitor by 
using the enable command. 

This command is valid for mult i -drive devices only and 
affects drives, not controllers. 

The format of the command is: 

E drive -number 

An example of the enable command is: 

E 1 

This command enables drive 1 as the system device. 
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2.2.4 ICLP 

The help coMiend provides a brief suiMnary of XXDP commands. 
The contents of a file named "HELP. TXT" are typed/printed 
and this file must b€ on the system medium. There is a 
SMitch to cause the suMnary to be printed on a line printer 
instead of the console terminal. 

The format of the command is: 

HC/LI 

Examples of the help command are: 

H type the XXDP com^iand summary on the console. 

H/L print the XXDP command summary on the line 
printer. 
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2.2.5 Load Co—snrf 

The load commaAd is used to load a file into memory. This 
command can be thought of as the first half of a run 
command. The program is not started. 

As in the run command process, the full file name of the 
program that was loaded is printed. All restrictions in the 
run command apply. 

The format of the load command is: 

L filnam[.ext] 

Some examples of the load command: 

L DIAG (load DIAG.BI?) 

L ZDJCA2.NEU (load ZDJCA2.NEU) 



B3 
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SeO 0027 



Th« run co«Mr\d is uMd to losd and start a program that !s 
storsd or\ tH« losd. or systsu, mtdlum. (Note: the run 
coMand is a combination of the Load and Start commands 
described beloM.) The program must be an executable file. 

The format of the run command is: 

R filnam[.e«t] [addr] 

The file name must be a standard XXOP file name (see C^npter 
1 If the extension is omitted, a default extension (.BIN or 
.BIO is used. If the medium contains a file Nith the Qiven 
name and both default extensions, the first file found is 



After the program is found and loaded, but before the 
program is started, the full file name is f^rinted to verify 
the load. This report is useful in determining which of 
Dossibly several programs on a medium is being run after a 
wildcard specification. 

"^he file Is started at the transfer address in the file (or 
at 200 octal in the absence of a transfer address). You can 
soec'fy a starting address with the run command, if you want 
the file to start at a different point. 

Some examples of the run command: 



wildcard characters are permitted in the file specification. 
>e first file found that fits the wildcard description is 
.jseo. 



used. 



R UPDAT 

R SAMPLE. XXX 

R RXOIAG 204 



(load/start UPOAT.BI?) 

(load/start SAMPLE. XXX) 

(load/start RXOIAG. 61? at location 204) 



C3 
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SEQ 0028 



2.2.7 Start Co— w< 

The stert coMend is used to start a file that has been 
previously loaded into core by a load command. No commands 
should be issued between a load and start command since the 
orooram loaded will most likely be overwritten. The purpose 
of this command seouence is to allow the user to load a 
program, halt the processor, modify memory contents, restart 
the monitor and start the program. 

'^he format of the start command is: 



If you do not give a starting address, the monitor starts 
the program at the transfer address in the file. The 
default starting address for files without specific transfer 
addresses *s 200 (octal). 

Some examples of the start command: 



S [addr] 



L RXDIAG 
S 



(load RXDIAG. BI?) 

(start at transfer address) 



L RXDIAG 
S 204 



(load RXDIAG. BI?) 
(start at 204) 



J 
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sect or* describes the XM monitor co«i<wends. Note that 
t^ ^ III coMand is no logger supported under the XXDP XM 
•on " tor . 

^he ^^D^ Mon'tor coMRands are suNMiar zed below: 

BOOT Boot a device 

PlW run a program 

LOAD load a program 

START start a program 

COP> Copy a file or device 

CHAIN run a batch job (chain) 

DATE Set the date or report the date 

DELETE Delete a fUe 

DIRECTORS list directory of load medium 

ENABLE enable alternative drive for system device 

HELP type help information 

INITIALIZE Initialize a device 

PRINT Print a file on the system line printer 

RENAME Rename a file to a new name 

SET Set device or system parameter 

TYPE Type a file 



Some commands have optional switches. See command syntax 
be low « Switches are jsed to mod'fy the command function. 



E3 

SEQ 0030 
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2.3.1 tmmm$ Syntox 

syste« occ«pts coMnands m cither: (Da complete 
•tr'ng containing all the information necessary to execute a 
coMnand or (2) as a oartial strino. In the latter case the 
system oromots for the rest of the information. 

General syntax for a command is: 

command! /snitch] Input- file spec 
output- f I lespec 

or 

command! /snitch] 
promptl? input-f ilespec 
prompts? output-f ilespec 



Mhere: 

command is the command name 

/snitch represents a command qualifier that 

specifies the exact action to be taken. 

prompt represents the keyboard monitor prompt 

for more Information. An appropriate 
prompt will be printed only if an Input 
or output file of device specification 
Is omited. Not all commands will print 
prompts. This Is a feature of the monitor 
only, UPOAT does not have this feature. 

'nput'f Ilespec represents the file on which the action 
Is to be taken. 

output-f Uespec represents the file that Is to receive 
the results of the operation. 
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A ^'l«sp€c rep»*eMntt a spaclffc fila and the device on 
*t is stored. Its syntax Is: 

dev:f Ilna«.typ 

••Here: 

dev: represents a device name. If the naine is omitted 
then the system device !s assumed by default. 

f'lnam represents the one- to six-character name of file 

Uildcard characters are permitted in the file 
specification. 

.typ represents the one- to three-character file type. 



2.3.2 NfekTMirting Kayfca^rd Comman<a 

Although keyboard commands are all Engl Ish-languaoe Mords 
and therefore easy to use. It can become tedious to type 
Mords litre PRINTEA and INITIALIZE frequently. Abbreviations 
can be used which are the minumum number of characters that 
are needed to maire the command or option unique. In the 
^olloM'ng sectons the required part of the name is shown In 
jpper case and the optional part In lower case. 
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MOT Umm$ 

Th# ooot coMiond directs the monitor to boot another XXDP 
Monitor from another XXQP device. This command line is 
oarsed nto a format that is acceptable to UPDAT and then 
control 's oaaaed to UPOAT to boot the device or system 
spec' fed. 

^h« format of the boot command is: 

Boot dev: 
"^n example: 

B DUO: 

The appropriate device handler must be present on the system 
oev'ce. 
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2.S.4 CHUN Coiwi 

TK« cH«*n coMand is uMd to Initiate execution of a batch, 
or cHa'n. file. The file iniat be on the system medium and 
must have a .CCC extension. Some batch operations accept 
SM Itches. 

The format of the chain command is: 
CHAIN filespec [/^.^ itches] 
ChsDter 6 of this manual describes batch control in detail. 



H3 

SEQ 0033 
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2.S.5 COPY 



The cooy co—snd performs a variety of file transfer and 
maintenance operations. The command line is parsed into a 
format that is acceptable to UPOAT and then control is 
0—^4 to UPDAT to perform the operation specified. 

^he format of the copy coMiand is: 

COpy [switch- list] input- file spec output- filespec 

The follOMing switches can be used: 

/Boot copies the root monitor from the input 

device into the boot block of the output 
device. The command places the 
appropriate secondary bootstrap in the 
boot block and places the monitor file 
on the medium in a predetermined 
section. The root monitor consists of 
XXDPSH.SYS merged with driver of the 
output device. 

/Files -^copies all files from the specified input 
device onto the specified output device. 

/DEVice *- copies a device in image mode to a like 
device. A copy to a device which is not 
Identical causes the coMiand to abort. 
Also bad block devices nay also fail 
during execution of this coiMiand. 

/DElete copies a file or files froai the 
specified Input device onto the 
specified output device and 
automatically delete any file If it 
already exists. 

Example of the use of the copy command: 

COPY A, BIN DYO: 

'^h's command copies the file A. BIN from the system device to 
0*^0: us'ng the same name. 



13 

SEQ 0034 



J3 
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2.S.6 DATE Co—^d 

The date coMand lets you inspect or to set the current 
system date. 

The format of the coMiand Is: 

OAte [ dd-mmm-yy ] 

dd represents the day (a decimal number from 1 to 31) 

wmm represents the first three characters of the name of month 

yy represents the year (a decimal number from 83 to 99), 

If the command is given with a date, that date is set. If 
the command is g'ven without a date, the current date is 
printed. 

DATE 18-MAY-83 Sets the date 

DATE Obtains the current date 

18-MAY.83 

If no date is presently set a default date of l-JAN-63 is 
jseo. 



SEQ 0035 
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2.S.7 oarrE cp—w< 

The delete coiMiand deletes the specified files. The name of 
each file that is deleted is printed and, for tape devices, 
the tape I's rewound after each file is deleted. 

The format of this coiMiand is: 

OElete [/NOnames] [/NORewind] filespec 

o /NOnames prevents the printing of the name of 
each file as it is deleted. 

o /NORewind prevents a tape drive from rewinding 
between files when deleting multiple files. 

An example of deleting a file: 

DELETE DKO:ABC.BIN 

^h's command deletes the file ABC. BIN from the device DKO. 



L3 
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SEQ 0037 



2.3.0 DIRECTORY Co— wd 

Th« directory coMtand is used to obtain a list of all the 
files on the system nedium. This list contains five items 
of inforijation: the entry nunber, the complete file 
specification (name and extension), the date the file was 
created, the lenath of the file in 256 (decimal) word blocks 
and the number of the first block in the file. Host files 
are "linked"; that is, their blocks are not in order on the 
medium. A feM files are contiguous: that is, their blocks 
arc in order on the medium. Contiguous files are noted in 
the directory by a "C following the date. 

Uhen the directory command is given, the monitor parses the 
command line, loads the UPOAT utility and passes control to 
UPOAT. 

The format of the directory command is: 



There are two optional switches for the directory command. 

o /Printer causes the directory to be printed on a 
line printer rather than the console terminal. 

o /Fast causes the directory to printed in a Short 
form: entry number and file name. 



Directory (/Printer] [/Fast] 



Directory Long Form 



ENTRY* FILNAM.EXT 



1 XXDPSM.SYS 

2 OY .SYS 

3 OIR .SYS 



DATE 
02-JUN-79 
02-JUN-79 
02-AU6-79 



LENGTH 
12 
5 



6 



START 
000100 
000120 
000066 



Directory Short Form 



1 XXDPSM.SYS 

2 DY .SYS 

3 OIR .SYS 
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2.3.9 ENMLe Co— 

The enable cotmmr>4 is used to change the drive that the 
Monitor considers to be the system device. For example, if 
the user had booted the system from drive 0 of an RX02 and 
later wanted to have the monitor use drive 1 as the system 
device (that is. as the default device), he or she could do 
this without re -booting the monitor by using the enable 
command. This command is valid for mult! -drive devices only 
and affects drives, not controllers. 

The format of the command is: 

Enable drive -number 

There must be valid XXQP V2 media in residence on the 
specified drive or the system will not allow the command to 
complete and an invalid device error will be invoked. 
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2.S.10 Hap C o — snd 

The help coMisnd is used to obtain a brief summary of XXDP 
coflMRands. The contents of a file named "HELP.TXT^' are 
typed/printed and this file must be on the system medium. 
There is a switch to cause the summary to be printed on a 
line printer instead of the console terminal. 

The format of the command is: 

Help [/Printer] 



o /Printer lists the help on the printer. 
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a.s.a naTMLiZE coMind 

TK« nitislizc coMiarid is used to clear and Initialize a 
device directory. 

The format of this coMiand is: 

Initialize device 

The Initialize coMsnd initializes a medium by clearing the 
bit map (random access devices) or writing an end-of-tape 
mark (seouential access devices) and placing an empty 
d*rectory on the medium. 

CAUTION 

All data on the medium prior to a this operation Is 
Irretrievably lost after the operation. The monitor 
makes no attempt to determine what is on a medium 
and will destroy customer data* 

A warning is printed whenever this command is invoked, 
stating which device is involved. The user must then verify 
that the zero operation is to take place. 

An example of the command is: 

INI DYl: 

There 's no default for the device. The device «ust be on 
l*nc and write -enabled. The following warning is issued 
a'ter the coMiand Is entered: 

.SEP DATA m dev WILL 8E DESTROYED! .... PROCEED? (Y/N/CR-N) 

^he c .y answer that confirms the users Intent to carry on 

's ' ' . 

An aod't'onal warning message Is printed If you specify the 
systes dev'ce 'n this coMand. 

:n:'ia.:ze s^steh device .... proceed? (</n/cr-n) 

w'sh to proceed w'th the process, you »ust type a 
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LOUD C < 

load coMnand is used to losd a flic nto m^mor^. This 
coMsrd car» be thought of as th« f >st Half of a run 
coMand. The orogra* is not started. As in the run coMiand 
orocess. the full file name of the prograni that was loaded 
'% or'nted. All restrictions In the run coiMiand apply. 

'he format of the load coMand Is: 

Load f'lespec 

So^ e^ aisles of the load co«nmand: 

.3AD OIAG (load DIAG.BI?) 

.OAO ZDJCA2.NEU (load ZOjCA^.NEU) 
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PUNT CiMiHi 

*H€ ^fllN"^ coMttAd l'«t« the contents of one or more files on 
SMc'f'cd dtvice to the system line printer. 

"Ke ^ormst of tH;s coMsnd is: 

Pr'nt [/Norenind] filespc 

Norew'nd switch prevents • tsp« drive from reNinding 
betMsen fUes when printing multiple files. If this switch 
's not g'ven, the tmp€ *s rewound after each file is 
pr >ted. 

Some examples of the print command: 
PRINT DUO:SYSTEM,CCC 
P H miz^.lXl 



D4 

SEQ 0042 
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rmnmm c o— n d Is ussd to change the file specif !cst ion 
of an sxisting file without doing s transfer. The name of 
the f *le as recordtd in the directory is changed, but there 
;s no i^veaent of data. 

The forwat of the co—and is: 



In the CO— and syntax illustrated above. !nput*f ilespec 
represents the file to be renaiied. and output-f ilspec 
represents the new na»e. The device specified in filespec 
*s assumed to be online and write -enabled: device must be 
the sa»e for both Input and output. This coiMiand can not be 
used on a tape device. 

Ei^ainples o^ the renaae coMiand: 

RENAME DYliDIAG.OLD DYliDIAG.BIN 
*H s coMiand renames the file DIAG.OLD on DYl to DIAG.BIN. 



REni 



input-f ileapac output-f i lapse 
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RUN Commd 

Th« run coMand is used to load and start a program that !s 
stortd on th« load, or system, medium, (^k>te: the run 
command a combination of the load and start commands. ) The 
progrsM must be an executable file. These are only files 
with .BIN or .BIC extensions to their names (such as. 
UPOAT.BIN). 

The format of the run command Is: 

Run flleapec [addr] 

The file name must be a standard XXOP file name. The 
default extension is .BIN or .BIC. If there Is a file nth 
both extensions on the medium, the first file found will be 
used. 

After the program Is found and loaded, but before the 
program Is started, the full file name Is printed to verify 
the load. This Is useful In determining which of possibly 
several programs on a medium Is being run after a wildcard 
specification. 

The file *s started at the transfer address In the file (or 
at 200 octal in the absence of a transfer address). If you 
want to start at a different address, you can specify the 
starting address. 

Some examples of the run command: 

RUN UPDAT (load/start UPDAT.BI?) 

RUN SAHPLE.XXX (load/start SAf«>LE.XXX} 

RUN RXOIAG 204 (load/start RXOIAG.BI? 

at location 204) 

UUdcard characters are permitted In the file specification, 
'^he first file found that fits the wildcard description will 
bt run. 
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The set coMend changes device handler characteristics and 
ce^tan system configuration parameters. 

The format of this COMSnd is: 

SEt [ physical*device-na«e ] cond'tion 
I item 1 

In tne coMMnd syntax above, "physical-device-na«e' 
represents the tne device handler Mhose characteristics need 
to be iiodified. The argument "item" refers to a system 
oarameter that needs to be modified. Presently the only 
system parameter that is changed by the set command is the 
follOMtng: 

SET TT: SCOPE 

*^h's option echos RU60UT characters as 
bacifspace- space -backspace The default is NOSCOPE. 

SET TT:NOSCOPE 

This option echos R160UT characters by enclosing the deleted 
characters in backslashes. This is tne normal mode. The 
system returns to this condition on reboot. 

SET TT: QUIET 

The QUIET option prevents the system from echoing lines from 
the cha*n file or from diagnostics that maybe runnino from a 
cha'n f*lc (providing the diagnostic has LrD support;. 

SET TTrNOOUIET 

^he NOQUIET opt 'on echos lines from chain files or from 
d'ayiost'cs that are running from a chain file. This is 
default mode. 
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2.S.17 STMT Cmmni 

TK« start coiHRand is usad to start a flic that has bacn 
loadad 'nto cora by a load coMiand. No coiMiiands should be 
issuad batwaan a load and start coMiand since the program 
loaded will Most likely be overMrltten. The purpose of this 
co«»and saouence is to let you load a program, halt the 
processor. Modify mmory contents, restart the monitor and 
start the prograai. 

The format of the start coMand is: 

Start [addr] 

>ou can enter a starting address. The monitor starts the 
program at the transfer address in the file if you don't 

?;ve a starting address. The default starting address for 
*las without specific transfer addresses is 200 (octal). 

SoM axaaiplas of the start co«»and: 

LOAD RXDIAG (load RXDIAG.BI?) 

START (start at transfer address) 

LOAD PXOIAG (load RXDIAG.BI?) 

S^ART 204 (start at 204) 
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The type coMnsnd prints the contents of a f !le on the 
temiral. 

The format of the coMand is: 

Type [/NoreMtnd] filespec 

In the coiMiand above the filespec represents the file or 
files to be typed. Uild cards are accepted in the filespec. 
The entire coMand may be on one line or the system can be 
relied on to prompt for information. The type command 
proi^t Is "FILE?" 



o /Norewind prevents a tape drive from rewindino 
between fil«s when typing multiple files. Default 
is a rewind after each operation. 



CHAPTER 3 
THE DIAGNOSTIC RUNTIME SERVICES 



Diagnostic Runtime Services (ORS) are the part of the 
XXOP System that control compatible diagnostic programs. 
ORS Is an extension to the the XXDP Runtime Monitor that is 
automatically loaded into memory and started Nhen a 
compatible diagnostic is run. DRS also provides 
non- test -related services (such as. console terminal 
support) to these diagnostic programs. 

This chapter has five parts: 

1. DRS description 

2 . commands 

3. switches, or command modifiers 

4. operational flags. 

5. table building process 



3.1 Dmmcriptflon 

There are two DRS systems used by XXDP: 

o DRSSM a small DRS system 

o DRSXM -- an extended DRS system 

Uhen the XXDP SM monitor is booted, the corresponding small 
DRSSH Is loaded for the diagnostic. Uhen the XXDP XH monitor 
's booted, the larger DRSXM is loaded for the diagnostic. 
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The DffSSn provides the seine capablities that the old DPS did 
for XXDP VI, 1. The DRSXM allows larger diagnostics to run 
and provides an additional coniinand as described beloM. 

All diagnostic programs that are compatible Mith DRS share 
some important commo n features. Because of these features, 
they have identical structures* respond to the same general 
set of commands, report errors in the same May, gather 
hardware and operational data in the same manner and are 
therefore easier to use and control from both a user and 
system point of view. 

If you are unsure of which diagnostic programs on a 
particular medium are DRS-compat ible, you can use the SETUP 
utility to list these diagnostics. Chapter 6 describes 
SETUP. 



3.1.1 ORS Stort-up 

The start*uD procedure for DRS is straightforward. Uhen you 
'ssue an XXDP run command, the diagnostic is loaded and 
started. The first thing the diagnostic does is to execute 
an EHT Instruction that transfers control back to the XXDP 
monitor. XXDP then loads DRS from the system medium. 

The DRS file Is DRS??. SYS where "??" represents the 
designator for the small DPS (SM) or large DRS (Xn). DRS 
sizes memory using memory management prior to going into 
command mode. If this hardware has problems, uRS does not 
start properly. You must run memory management diagnostics 
'f you encounter this problem. 



3.1.2 ORS Concepts 

You Should be aware of several concepts about DRS. 

o CONSOLE COMHANDS - DRS communicates with you 
through the console terminal. There are eleven 
commands available for controlltno DRS operation. 
Unlike older -type diagnostics. DRS does not vary 
Its operation based upon starting address or 
switch registers". 



I<4 

SEQ 0049 
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0 COMMAND MODIFIERS (SWITCHES) AND FLAGS - You can 
alter the effects of a particular command by 
specify ino a "switch" when the command is given. 
For example, unless otherwise specified, most 
commands will affect all units (devices) that the 
diagnostic can test. A switch can be used to limit 
the effect of commands to certain units only. 

o UNITS ' The diagnostic acts upon specified 

hardware. Each individual hardware "entity'' is 
r^ferr^d to as a unit -under- test (UUT) or, most 
c o mmonly, as a unit. DPS is equipped to handle up 
to 64 units. You refer to a unit by a number. The 
first unit is "0". Units are numbered according to 
the order In which they were specified (see 
HARDWARE TABLES below). 

O HARDWARE PARAMETER TABLES - DRS-compat ible 

diagnostics do not autosize (determine hardware 
information by performing bus-related tests). You 
must give the diagnostic the Information about the 
hardware under test that Is necessary. This 
Information Is stored In a set of tables called 
"hardware parameter tables". There is one table 
for each unit to be tested. The specific 
information required is dep^rsiitrst upon the 
diagnostic. The diagnostic program prompts the 
operator for the information it needs for each 
unit, starting with unit 0. The important concept 
that you must grasp !s the concept of a "table 
driven diagnostic" in all of the information about 
a hardware unit is contained in a table specific to 
that unit. 

o SOFTWARE PARAMETER TABLE - There are operational 
parameters that you can select that affect the way 
in which a particular diagnostic will function. 
This Information is placed into a table of data 
called the "software parameter table". This table 
(for those readers familiar with earlier processor 
designs) takes the place of the switch register. 

o PASS - A pass, or unit of diaonostic operation, is 
defined to be the execution of all specified tests 
for all active units -under -test. 



L4 

SEQ 0050 
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o TEST - DRS diagnostics are divided into independent 
stuctures called tests. You can run all tests in a 
d' agnostic or select any subset desired. 



S.l.S Error NMMgag 

When a diagnostic detects an error in the device being 
tested, it calls upon ORS to report the error to the 
operator. There are three levels of error messages: 
header, basic and extended. The first inessage level 
supplies some general information about the error, as shown 
In the example below: 

ZNAHE HRO ERR 00002 ON UNIT 5 TST 012 SUB 000 PC: 013134 

The information given in the header is: 

diagnostic name - "ZNAKE" 
error type - "HRD" 
error number - "00002" 
unit number - "5" 
test number - "12" 
subtest nuM^r * "0" 

location of error call to DRS - "013134" 

The error number is for identification and is not a running 
total of the number of errors that have occurred. 

The basic error level is used to give a short, simple 
description of the error. The extended error level is 
typically used to give supporting information such as 
register contents at the time of the error. For example: 

ZNAHE HRO ERR 00002 ON UNIT 5 TST 012 SUB 000 PC: 013134 
REGISTER FAILED TO CLEAR AFTER BUS RESET 
CSR: 000000 SCSR: 010000 ERRRE6: 000000 

The first line Is the header message, the second is the 
basic message and the third line is the extended message. 
Error messages are divided into levels in order to give the 
operator flexibility In determining nhat portionCs), if any, 
of the error reports mIII be displayed or printed. 
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3.2 



There art eleven coMiands to the ORSSM and twelve to the 
DRSXH. These coMiands are entered in response to the DRS 
prompt: 0R>. The prowipt is issued after the DRS is loaded, 
after all specified diagnostic operations are completed, 
after a ORS detected error, after a "halt-on-error" sequence 
and after ORS has been interrupted by a tC (CTRL-C). These 
are tabulated below and described in the remainder of this 
section. The commands are grouped by related function. 



Execution 

START 

RESTART 

CONTINUE 

PROCEED 

Data Collection 

REDIRECT 

Units Under Test 

DROP 
ADO 

DISPLAY 



Til 



Flags 



TIME 



FLAGS 
ZFLAGS 

Statistics 

PRINT 
Emitting 

EXIT 

The descriptions below 



start the diagnostic and initialize 
start diagnostic and do not initialize 
continue diagnostic at test that was 

interrupted by a .tC 
continue from an error halt 



redirect error prints and statistics to 
another unit and/or the line printer 



deactivate a unit 

activate a unit for testing 

print a list of device information 



set the time of day or display the current 
time of day. 



print status of all flags 
reset (clear) all flags 



print statistical information 

return to XXDP monitor 
describe the effect of each command. 



SEQ 00S2 
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These effects may be inodifed by the use of switches that 
are ascribed In the next section. Familiarize yourself 
w'th the coMmands before trying to use the switcnes. The 
co"» tarda can be recognized by the ORS from a minimum of 
three characters; thus the use of the square brackets. That 
's. the start command can be entered as 'STA" or 'STAR" or 
'START , 
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HBP C < 

sdO CO— and uMd to octivoto o unit for ttstlng. The 
^'t SM'tc^ uMd to to^cify tK« uf^it to b€ •ctivatcd (sec 
Mct'o^ All units art initially actlvt or^d iHJSt be 

cxol'c'tly dtactlvatad by tK« uMr or tH« tfiMnostic. The 
>^*t9 to bt activated «ust Hav« already been deactivated. 

*He format of the co — nd Is: 

ADD [/UNIts:un;t<nuaber] 

."n't nuaber Is tHe unit to be act'vated* Section 2 of th's 
c^eote^ descr'bes the unit switch In detail. 

'•*e default oocratlo^^ of the add co—end Is: 

o If the /UNITS SMitch Is specified, the given unit 
s actvated. 

o If the snitch Is not sosclfled. all deactvated 
jn'ts are returned to active testing. 
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9.2.2 CfMTINUE Cmmm^ 

Th€ continue coM«nd i» us€d to rtSKjmt diagnostic op«rat'on 
a^tar intarruptad by a tC or aftar a halt on arror. TKa 
d' agnostic is restarted at tKa beginning of the test tKat 
was ntarruptad. not at the first test, as would ba tKa casa 
w'th the RESTART coMand. The unit being tested when the 
d'agnost'c was interrupted remains as the unit being tested. 
>ou are 9iven the opportunity to change the software table 

you wtsh. You are not able to change the hardware 
tables. 

format of the coMand is: 

CONtlnue [swltch-list] 

Sw'tch-l'st Is any valid co^Bbinatlon of switches (modif ers) 
for the continue coMand. Section 2 of th's chapter 
describes these switches. 

default operation of the continue conMand Is: 

o The testing runs for the number of passes remaln'ng 
In the pass count specified in the last start or 
restart coMand. (A pass Is defined to be all 
specified units tested once by all specified 
tests. ) 

o All flags will remain set/clear as previously 
specified. 



Example of continue command (underlined portions typed by 

DRS): 



WlfHX SU LU 2 N 

"^ou can also use the start and restart commands to resume 
o'agnostic execution, but diagnostic Initialization will 

place and testing will start with the first unit, first 

test. 
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9.2.9 OXSPLAY CiMiM 

d* splay coMarvd is um^ to axamtna th« contents of the 
Ha^dMsra tablas. All tab^a data for tha spaciflad units are 
I'steo on the console ter^^inal. Units that Have been 
drooped are so designated. 

^omat of the coMnand Is: 

Display [swltch-llst] 

Sw'tch I'st 's sny valid combination of SMitches (modifiers) 
^or the d* splay coMsand* SMitches are described in section 
c o^ th's chapter. 

*h« default operation of the display coMsand is: 

o AH Lin'ts described in the hardware tables Mill be 
o' splayed on the console terminal. 
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S.2.4 mOf CiMwi 

d^oo coMand !• us€d to dtactivatc s unit from testing. 
Th« urit to b« dtoctivatcd iiust b€ specified using the unit 
SMitcH (sM section 2). All units arc initially active. 

The for*at of the coMiand Is: 

OROp [/UNItsiunlt-nui^r] 

l>n;t*nuffber Is the number of the unit to be deactivated. 
The unit switch *s described In detail In section 2 of this 
chapter . 

"^he default operation of the WOP comaiand Is: 

o If the /IMITS switch Is specified, the given unit 
's deactivated. 

o If the switch Is not specified, all active units 
are dropped from active testing. 
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FLittS Cmmmi 

TKt flags coMsnd is used to find the current status of the 
OAS flags. Upon receipt of this command, DRS will display 
the status of all flags on the console terminal. 

The format cf the command is: 



Exaaola o^ the flags command (underlined portion typed by 
OAS): 



No flags are set. 




^here are two flags thst hav# been set: lER and LOE. 
:^hese flags are described a later section.) 



^LAgs 
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S.2.t MKXXED Co—mJ 

The proceed coiiMAd is used exclusively with the 
halt -on error feature in DPS. When halt on-error s m 
force and the diagnostic reports an error to DPS. OPS 
returns to CO— and «ode. You can issue any coMiands at this 
point. The proceed coMnand is special in that it restarts 
the di a9nostic at the point Mhere It reported the error. No 
Initialization Is done, the unlt-under-test is not accessed 
and the vector space Is unchan9ed. This process allows you 
to e«aaiine the state of the unit beln^ tested and then 
continue testing Mithout disturbing diagnostic operation. 

The format of the coMiand Is: 

PROceed [swltch-llst] 

Switch-llst is any valid co«ibination of switches (modifiers) 
for the PPOCCCO command. These switches are described in 
section 2 of this chapter. 

The default operation of the proceed command Is: 

O the flags (section 3 o^ this chapter) remain 

set/clear as specified with the previous command. 
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1.2.7 RCDXIKCT CmmK 

Th« redirect comm an d is ava liable In the ORSX Nhich operates 
frpm extended nenory. This command causes certain 
information to be redirected to a device instead of being 
printed on the terminal. The information that is redirected 
is error information, statistics, drop units, and End of 
Pass information. 

The format of this command is: 

RCDirect [/Oev] [/LPT] file-spec 



The /DEV switch allows the name of a device to be 
entered on nhich the data is to be stored. The 
data IS collected in a file named COLECT.DAT. If 
th;s ^ile is not present, it is created and data Is 
added to It. If the file is present, it is opened 
and data is appended to the end of the file. The 
file Is opened at the beo Inning of each pass of the 
diagnostic program and closed at the end of the 
pass. 

The /LPT switch causes the Information to be 
printed on the system line printer In addition to 
being collected on the device specified by the OEV 
switch. The file Is closed any time there Is a 
return to c o mmand level. A tC or trap causes a 
return to command level. The date of the file is 
the current date and is updated if necessary. 

The command can be executed any time at command level. If 
the redirect Is canceled, the above information is output to 
the console terminal. The redirect command can be canceled 
by entering the command without any arguments. 

Example: 

DR>RED/DEV:DYO/LPT 
0R> 

E'ther or both switches can be used In any order. The 
device driver specified In the DEV: switch must be on the 
system media. An error message is displayed on the system 
console 'f the attempt to load the driver falls. 

The Information saved on the storaoe device/serial line or 
I'ne pr'nter Is 'nformatlon normally printed from: 
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1. Error calls. Error block call, and all PRINT? 
calls that are within the scope of that error call 
(for example: the error sub- routine, extended 
error message, etc.) 

2. PRINTS calls 

3. the end of pass printout. 

Informattori contained in PRINT? calls that are not within 
the scope of the error are not saved and are output to the 
console terminal. 

This data is stored in ASCII form Just as the diagnostic 
program passed them to the ORS. No data compression or 
other formatting is accomplished on this information. 
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3.2. e RESTART Co— 

The restart coMiaod, like the start command, starts the 
d' agnostic from an initial state. The diagnostic 
initialization process may be different in response to a 
restart. Please refer to diagnostic documentation for 
details. The vector space is not changed. You only have 
the opportunity to change the contents of the softNare 
table. 

The format of the command is: 

REStart [sNi tch-1 ist ] 

Switch-list is any valid combination of switches (modifiers) 
for the restart command. Section 2 of this chapter explains 
switches. 

The default operation of the restart command is: 

o All tests are run on all units. 

o Flags (section 3 of this chapter) are cleared. 

o The testing continues until interrupted by a C or 
by a system error. 

o An end-of-pass message is printed after each pass. 
(A pass Is defined to all specified units tested 
once by all specified tests.) 



DR>RES 
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3.2. 9 STMT Co— »id 

The start coMnand starts the diagnostic from its initial 
state and should be the first command issued to ORS. All 
init ializavion code is executed. Refer to specific 
diaanosttc docuMntat ion for exact nature of the 
initialization process carried out by a particular 
diagnostic. The "trap catcher** code is reloaded into the 
vector space. (The trap catcher is code that allows DRS to 
handle and report any unexpected interrupts.) 

The fomat of the coflMsnd !s: 

STArt [sHitch-ltst] 

SMitch-list Is any valid coiibination of switches (modifiers) 
for the START coflMand. The switches are explained in 
section 2 of this chapter. 

The default operation of the START command is: 
o All tests are run on all units. 

o All flags (section 3 of this chapter) are cleared. 

o The testing continues until interrupted by a tC or 
by a system error. 

o An end-of-pass message is printed after each pass. 
(A pass is defined to be all specified units tested 
once by all specified tests.) 

After you issue the start command, you are asked if you wish 
to change the hardware information. You must answer yes 
("Y") to this question if there are no existing hardware 
tables. Hardware tables will already exist if they were 
entered: 

1. By a previous start command sequence 

2. By use of the SETUP utility 

3. By a programmer who hardcoded tables into the 
diagnostic image. 

fou can override existing tables at this point if you wish. 

<ou are then asked for the number of units to be tested. 
Enter the decimal number of units. You are asked for 



M5 
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SEQ 0064 



hardMare-specif ic inforwatioo for each unit according to the 
des'gn of the diagnostic. 

Exaaiple of START (underlined portions typed by ORS): 



Vou are asked for the hardware data for *'n** units, where "n" 
*s a decimal number between 1 and 64. Refer to section 4 of 
this chapter for assistance in answering these questions. 
Th« questions should be obvious and straightforward. If you 
have difficulty with the questions of a specific diagnostic* 
please refer to the document for that diagnostic or direct 
questions to Diagnostic Engineering. 

After you enter all hardware data, you are asked if you wish 
to change the operational data (software table). This is 
purely optional. You do not have to answer any software 
data questions unless you want to modify default diaonostic 
operational behavior. Section 4 of this chapter will assist 
you in answering the questions, but please refer to 
diagnostic documentation for explanations of specific 
quest Ions. 

If there are no hardware tables, you get an error message. 
The following example shows what nappens when hardware 
tables are not present: 




[answer diagnostic questions] 

CHAffCC SW LL} 2 N 



Qe>STA 




N 
N 



08 > 
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3.2.10 TIVC Co—yid 

The time coMsnd sets the time of day or displays the 
current time of day. This command is only valid for 
DRSXM.SYS. 

The format of the command is: 

TIME thh:min:ss] 

hh represents the hour (a decimal number from 1 to 23) 
mm represents the minutes (a decimal number from 0 to 59) 
ss represents the seconds (a decimal number from 0 to 59). 

An example of setting the time: 

DR>TIME 11:15 

An example of obtaining the time: 

DR>TIME 
11:15:01 

If no time is presently set a default time of 00:00:00 will 
be used and the system Nill increment from that time. If no 
clock is available on the system an error message is printed 
Hhen the time command is invoiced. 



XXOP UMr's Gultft Th« OAS 

S.2.11 2FLMS CpMiwi 

Th« z^lsgs co w n« resets sll 
•tst«. 

Th« fomtst th« coMtand is: 
ZF-Lags 



Pagt 3-19 
ORS flags to their cleared 



B6 



SEO 0066 
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S.9 SvitchM 

SM*tcH«t art Modifiers of coMiioncI functions. For example, 
»sny O^S coMiands affect units. Usually a coMnand of this 
type affects all units specified during hardMare table 
build. A sMitcK enables you to limit the effect of the 
to certain selected units. 



C6 

SEQ 0067 



OAS MitcHcc art: 

TESTS : t««t - 1 'st execute only th« tests specified 

PASS:ddddd execute ddddd passes (ddd<M - 1 to 65536) 

^LAGS:fl»g-i;st set specified flsQS 

''EO^tddddd report end-of-pess after each ddddd passes 

(ddddd - 1 to 65536) 

/LMITS:un't-list coMRand will affect only specified units 

All Sto*tcH«« cannot b« used witK all coMands. Tha 
^oIIoM'ng tabla ahoMa mMcK conmands each aw itch may be used 
n't**. 

TESTS PASS FLAGS EOP UNITS 



AOO X 

CONTINUE X XX 

DISPLAY X 

OAOP X 

EXIT 

FLAGS 

PRINT 

PfiOCEEO X 
REDIRECT 

RESTART XX XX X 

START XX XX X 

ZFLAGS 



S.S.I /EOF SMitdi 

''^^e /EOP switch is used to specify when end-of-psss messages 
w'll be printed. Thasc messages indicate the number of 

5ass«S completed and the number of errors found. Default 
PS operat'on is to print these messages after every pass. 

'he format of this sw'tch is; 

/EOP : number -passes 



XXDP V%€r s Gu'dt * The WS 



Page 3-21 



Mu^^r-oMMS is • decimal number between 1 and 65536. The 
«f\d-o^*oass tnessage is printed eacH t'me the number of 
passes spec'fied is completed. 

In the exa«ple below, the message is printed after every 90 
passes. (The underlined portion 's typed by ORS.) 

08>«ES/EOP:90 



S.S.2 /aUGS Suit:!! 

''he /FLAGS switch is used to set ORS operational flags. 
These flags are described in detail in the next section of 
th's chapter. Default DRS operation is all flags cleared. 

The format of this switch is: 

/FLAgs : flag-list 

Flag-list is a list of DRS flags separated by colons. 
Please refer to section 3 of this chapter for detailed 
descriptions of flags. 

Some exan^les of the FLAGS switch (underlined portion typed 

by DRS): 

>STA/FLAGS:LOE 
>RES/FlA:lOE:IER:BOE 



S.S.S /PASS Snitch 

^he /PASS switch is used to specify the number of passes 
tHat a diagnostic will run. A pass is all specified tests 
on all active units. Default DRS operation is ''no limit" on 
passes. This switch allows the you to place a limit on the 
number of passes. 

''he format of the switch 's: 

/PASs : number -passes 

Njmber -passes 's a decimal number between 1 and 65536. 
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SoMt cxawlcs tH« /PASS SMitcH (the underlined portion is 
tvMO by DAS): 

>STA/PASS:100 
>RES^PAS:1 



S.S.4 /TESTS SHitch 

Th« /TESTS Mitch is us€d to sptcify Mhst tests will be run. 
The defsult OAS operation is to run ell tests, but this 
sw'tch slloMS you to override the default. 

''he forget of the snitch is: 

/Tests: test-list 

Test-list is s list of test numbers separated by colons. If 
the test nuabers are sequent I al« they can be specified by 
the first and last test nuaber separated by a dash. 

^or evaaple. if tests !• 2. 3 and 4 are to be specified, 
they may be entered as ^1:2:3:4" or "1-4**. Test nunbers aay 
be entered in any order, but tests will always be executed 
'n nuncric order. 

So«e exaaples of the /TESTS switch follow. The underlined 
portion is typed by OAS. 

>START/TESTS:5 
>START/TES:1:2 
>fiES/TES:l:5-9:l5 

In the first coMiand, the user selected test 5 only. In the 
second coMand. the user selected tests 1 and 2. In the 
final coMand. the user selected tests 1. 5. 6, 7. 8. 9 and 

15. 



S.S.S /IflOTS SMitdi 

*^he /UNITS switch is used to specify which available units 
are to be tested. Default DPS operation is to encompass all 
jnlts 'n the scope of any coMiand. This switch is used to 
I'm't the effects of a command to certain units. The format 
o^ the command Is: 
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/LiNIts : units- list 

Un'ts list 's • l!st of unit numbers separated bv commas. 
ijn;t numbers are decimal numbers from 1 to 64. A unit is 
ass gned a number baaed upon order of entry *nto the tables. 
The f'rst un't IS unit 1. If the units are sequential, they 
may be specified by the first and last unit number separated 
by a dash ^or example, units 3. 4 « 5. 6 and 7 may be 

spec*f*ed as "3-7". 

Some examples (underlined portions typed by ORS): 

>D«0/UNITS:1 
>A0D/UNI:2.3 
>RES/UNI:5-9 

The f'rst example drops unit 1. The second example adds 
un'ts 2 and 3. And, in the last example, the diagnostic 
restarts with units 5. 6. 7. 8 and 9 being tested. 



S.S.S fai^iiiiiit SviUKM 

Vou can specify as many valid switches. In any order, with a 
coawand as you wish. Simply string out the switches* one 
after another, on the command line. 

^or example, 'f you want to start a diagnostic and: 

1. test units 1 through 4 only 

2. execute tests 1. 5 and 15 

3. execute 100 passes 

4. only report the end-of-pass data after every 10 
passes 



S.4 Fla«a 

^laos are used to set up certain operat'onal parameters such 
as loop'ng on error. AH flaos are cleared at startup and 
rema'n cleared until explicitly set using the /FLAGS switch, 
^lags are also cleared after a start or restart command 



G6 
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0071 



unless set usin^ the /FLAG switch. The zflngs command can 
also be used to clear all ^lags. No other commands affect 
the state of the flags » 



Flag Effect 



AOR execute autodrop code 

BOE "bell" on error 

EVL execute evaluation (on diagnostics which have 

evaluation support) 
HOE halt on error - control !s returned to 

runtime services command mode 
IBE Inhibit all error reports except first level (first 

level contains error type, number, PC. test and 

unit) 

IDR Inhibit program dropping of units 

lER inhibit all error reports 

ISR Inhibit statistical reports (does not apply to 

diagnostics which do not support statistical 
reporting) 

IXE Inhibit extended error reports (those called by 

PRINTX macro's) 
LOE loop on error 

LOT loop on test 

PNT print test number as test executes 

PRI direct messages to line printer 

UAH unattended mode (no manual Intervention) 



S.4.1 AOR Flgg (AuUMlap) 

The ADR flag, when sett causes DRS to execute the "^autodrop" 
code In a diagnostic. The purpoae of this code Is to test 
for 'device ready ' or "device available". If the unit being 
tested Is not ready or available. It is dropped 
(deselected). Not all diagnostics have autodrop code. 
Re^er to specific diagnostic documentation to determine if a 
d' agnostic does support this feature. 



3.4.2 ME Flat (Ball On Error) 

BOE flag, when set. causes ORS to Issue a "CTRL-G". or 
bell' chsrscter when sn error Is reported by the 
o'agnost'c. Th's gives an audible tone at the console 
term'nal. Th's feature 's normally used In conjunction with 
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tH« «€S»«9C inhibit functions. 



CVL Plat (EVaLiMte) 

TK« EVL flag. uKan Mt. cauMS DRS to axacMtc diagnostic 
evaluation code. This is an optional feature and you must 
refer to specific diagnostic docuMntat ion. 



NOE Flat (Halt On Error) 

The HOE flag, when set, causes DPS to execute a 
halt -on -error- seouence when an error is detected by the 
diagnostic. Execution of this sequence does not result in 
an actual processor halt, but returns DRS to coiiaand mode. 
^h« exact process is: 

1. Mhen the error is reported to ORS. the error 
aessageCs) are printed (unless printing has been 
Inhibited). 

2. DRS returns to coMiand mode. 

3. The diagnostic is suspended at the point of the 
error report to DRS and the unit being tested is 
left In the state that it Mas in at the time of the 
call. 

After DRS has returned to command mode, you can issue a 
proceed command to resume diagnostic execution at the point 
h«here It was suspended. You can also Issue other commands 
as desired. 



IK Flat (Inhibit Baaic Crrara} 

There are three levels of messages In an error report. The 
IBE flag, when set. causes DRS to inhibit the second and 
third level of error reports. The first level, which 
contains the error type, number, pc. test, and unit, is not 
■nh"blted. 
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S.4.6 lOR Flag (Inhibit ORopping of units) 

TK« lOR flag, when set. causes DRS to Inhibit the dropping 
(deselection) of units by a diagnostic. Diagnostics can 
deselect a unit from the test process if an error threshold 
's reached or if a serious error is detected. This flag 
alloMS you to keep the unit selected, usually for the 
purposes of tracing the error. 



3.4. 7 KR Flag (Inhibit Error Reports) 

The lER flag. Nhen set, causes DRS to inhibit all error 
reporting to the console terminal. While in effect, no 
messages are sent to the operator except system error 
reports such as ILL INT (illegal interrupt; and end-of-pass 
reports. This feature Is normally used in conjunction with 
error looping. It speeds up the test process and. in the 
case of hard copy terminals, saves paper. 



S.4.8 ISR Flag (Inhibit Statistical Reports) 

The ISR flag, when set. causes DRS to inhibit the printing 
of statistics by the diagnostic. This is an optional 
feature and not al.^ diagnostics support statistics. Consult 
specific diagnostic documentation to determine whether or 
not a diagnostic has this feature. 



S.4.9 IXE Flag (Inhibit aXtwidad Errors) 

The IXC flag, when set. causes DRS to inhibit the extended 
error reporting only. The error reports produced by the 
PRINTX call are inhibited. The error message and basic 
reports are printed. 



S.4.10 LOE Flag (Loop On Error) 

The LOE flag, when set, enables DRS error looping. When 
error looping Is in effect. DRS causes the diagnostic to 
continually re -execute the code that detected the error. 
Looping remains In effect even If the symptoms that prompted 
the error report d'sappear. This allows for looping on 
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inte»*iii ttent errors. To stop the looping, you must type 
CTRL-C (C) to return DRS to command mode. 



3.4.11 LOT Flag (Loop On Toot) 

The LOT flag, when set, causes DRS to continually execute 
th« test(s) specified with the TEST switch. The Initialize 
and end-of-poss code are not executed as In normal operation 
hoMver. 



9.4.12 PUT Flog (Print tkmbmr of Toot) 

The PNT flo9* when set. causes DRS to print the number of 
the test being executed. 



9.4.1S PHI Flog (PRIntor) 

The PRI flag, when set. causes DRS to redirect all messages 
to a line printer. This does not apply to command prompts. 



S.4.14 UM1 Flog (IMAttondod Hodo) 

The UAM flag, when set. prevents the use of manual 
*nterventton during testing. Manual Intervention assumes 
that an operator Is present to undertake any necessary 
action. The use of this flag allows the operator to start 
the diagnostic and let It run unattended. When this flag is 
'n effect, some testing will be inhibited. Refer to 
specific diagnostic documentation for a description of UAH 
flag effects In specific cases. 



S.S Toblo Building 

DRS uses hardware tables for unit Information (such as 
register addresses, drive numbers or interrupt priority). 
Tables are also used for diagnostic-specific operational 
Information (such as what data patterns to use for testing 
or whether or not to do read-only testing). The specific 
'nformat'on varies from diagnostic to diagnostic, so this 
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section ooly seeks to provide you Nith some background 
Information on these tables. 

These tables must be constructed. They are constructed !n 
three ways. 

1. The diaonostic is typically released (distributed) 
with only a "template" table for hardware data. 
This template contains default values for hardware 
information in some cases. In any event, you must 
build the actujl tables. This is most often done 
by starting the diagnostic with the start and 
specifying the hardware data as requested by the 
diagnostic. 

2. The table may also be "prebuilt" using the SETUP 
utility (Chapter 6). SETUP is an XXOP utility 
program that allows the user to build tables 
without actually running the diagnostic. The 
tables are stored with the diagnostic on the XXOP 
medium and are brought Into memory with the 
diagnostic at runtime. The user may then initiate 
diagnostic operation without building tables. 

3. The tables may have been built by the diagnostic 
programmer. These tables are already a part of the 
program Image and can be used as they are or 
changed after a START command. 

The operational table, which is called the software (SU) 
table, may not be present in all diagnostics. I^Jt is not 
present, you are not asked if you wish to change it. This 
Is an actual storage area that has default data coded into 
t. 

All table-related questions have the same format: 

Question (type) [default] ? 

The question may be somethlna like "ORIVE NUMBER".^ The type 
's a one character code for the type of answer desired, 
enclosed In parenthesis. The possible types and codes are: 
0 for octal. 0 for decimal. B for binary. A for ASCII and L 
for logical (Y or N). The question mark indicates that ORS 
's ready to accept the answer. If the answer is 
unacceptable for any reason, an error message will be typed 
and you are asked for the information again. 

Uhen you answer the hardware questions, you are building 
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entries in a table that describes the devices under test. 
Th« Simplest way to build this table is to answer all 
questions for each unit to be tested. If you have a 
nHjlt iplexed device such as a mass storage controller with 
several drives or a coNMnunicat ion device with several lines» 
this becomes tedious since most of the answers are 
repetitious. 

To illustrate a ii»ore efficient method, suppose you are 
testing a "ictional device* the XYll. Suppose this device 
consists of a control module with eight units (sub-devices) 
attached to it. These units are described by the octal 
numbers 0 through 7. There is one hardware parameter that 
can varv among units called the **Q- factor". This Q- factor 
may be 0 or 1. Below is a simple way to build a table for 
one XYll with eight units. The underlined portions are 
typed by ORS. 



UNIIS LQ} 2 8 






160000 
2 




160000 
3 




160000 
4 




160000 
5 
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LQ} 2 160000 
IQ} 1 6 
OJ Q 2 1 

OJ 1 2 

Notice that the ^fault value for the Q- factor changes Mhen 
a non- default response is given. Be careful when specifying 
■Kiltiple units! 

As you can see from the above exaniDle. the hardware 
paraiiieters do not vary significantly from unit to unit. The 
procedure shown is not very efficient. The runtime services 
can take multiple unit specifications however. Let's build 
the same table using the multiple specification feature. 

IWIIS COJ 2 8 
SR^aODBESS LQ}2 160000 



cse^AQceEss co: i 160000 




ESS LQ} 1 160000 
" COJ 2 6.7 
0^ 0 2 1 

As you can see In the above dialogue, the runtime services 
will build as many entries as it can with the information 
given in any one pass through the questions. In the first 
pass, two entries are built since two sub-devices and 
Q' factors were specified. The services assume that the csr 
address is 160000 for botli since it was specified only once. 
In the second pass, four entries were built. This is 
because four sub-devices were specified. The construct 
tells the runtime services to increment the data from the 
first number to the second. In this case, sub-devices 2, 3, 
4 and 5 were specified. (If the sub-device were specified 
by addresses, the increment would be by 2 since addresses 
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must be on an even boundary.) The csr addresses and 
0-f actors for the four entries are assumed to be 160000 and 
0 respectively since they were only specified once. The 
last two units are specified in the third pass. 

The whole process could have been accomplished in one pass 
as shown below. 



UNITS LQl 2 8 




As you can see from this example, null replies (commas 
enclosing a null field) tell the runtime services to repeat 
the last reply. 



CHAPTER 4 
UPDA7 UTILITY 



UPOAT ;s • file Manipulation utility program used for 
building XXOP media, copying flics r^om on« madium to 
another, deleting files trom a medium, modifying files and 
other functions. The component name for UPDAT is "CHUP2?? 
.IPOAT UTIL". but for the benefit of the user, the program Is 
released under 'ts common name: UPOAT 



4.1 OMeriptiaii 

jPDfi^ runs 'n the loMer part of memory and occupies about 6K 
words. It uses the runtime monitor for Interfacing to the 
ooefato*" and load'ng the retrievable device drivers that It 
jses to accomplish device related functions. Since UPOAT 
reduces these dev'ce drivers, the drivers you Intend to use 
»kjst be res dent on the system medium and tne system medium 
mjst oe ava'Iable Con-l'ne) throughout your use of UPOAT. 
**^r« 's one exception that 's eT<plaIned later In this 
chapter conjjnct'on w'th the DPI^ER command. 



4.1.1 Startii^ UPMT 

*c start ^0^^ . t^pe: 

^•^e#. tre program '^as oee^ sjccess^^IIy loaded by the 

tc. 't troes ts ra#ie a restart address and then 
*,pe5 t-^e prompt. • to tell ^oj t*^at t t *s ready to 
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4.X.2 tnmmm FiMtioM 

''H's Mctloo describes the command categories and then gives 
a detaUed descriptiort of each command. UPDAT commands can 
be d w'ded Into the folloMing categories: 

o ^tle manipulat lort commands 

O ^ile modification commands 

o ^teM medium creation commands 

o Hiscellaneous commands 

O Return to monitor commands 

o Print coiMiands 

following sections describe the commands 'n each 
category. 



4.1.2.1 film llvilpul«ti«i CoMWidi 

*^h« f* le manipulation commands are used to maintain XXOP 
med'a. Files can be transferred from medium to medium, 
deleted from a medium or renamed. A directory, or list, of 
^'les on a medium may be obtained. The file manipulation 
coiwands are: 

OIR give directory of specified medium 

PIP transfer a file or files 

FILE transfer a file or files 

DEL delete a file or files 

REN rename a file 



4.1.2.2 film fMif icctiaii 

ftn 'mportant function of 'JPDAT Is the modification of binary 
^*les. yhgn a diagnost'c program Is found to have a 
oef'c'ency, one of the correct ve measures ta^en is to Issue 
a D£PC or patch order'. Th"s 's a temporary change to a 
released orogram. 

Jp^*" 's one O* the means of 'mplement'ng these temporary 
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r««td'cs. Th« prograai in Quest on s loaded from an XXDP 
«€d'\j» nto an av^ea in iienory called tH« program buffer. 
*^*s a^ea l et *n the p^»y5 cal we»orv space bet>*een the 
MO^'to^ and UPQAT and its size 's determinad by the amount 
o^ «e*ory *n the system. Tha size *s equal to the svstem 
s re a nus 8K liorda, but no larger than 20K Mords. the 
program 'mage. noM resident in memory, may be modified and 
t^en pot bac»r onto an XXDP med'um ( dumped"). The transfer 
aoor^ss and load Image size may also be altered by the user 
at th's time. 

^ha na>it seven commands relate to this function of UPDAT. 
In the descriptions of these commands, locations within a 
program that has been loaded Into the program buffer are 
**eferrad to as 'virtual locations" since their addresses are 
relative to tha first physical location In the program 
buffer and not the first physical memory location as would 
be the case If the program had been loaded by the monitor. 

"^ha location addresses olven In a OEPO (Diagnostic 
Cng* Hearing Patch Order; are treated as virtual when using 
JPDAT. For example. If the DEPO says to modify location 
1002. that wUl be the virtual location you will refer to In 
the HOD command. If the program has been loaded by the 
monitor hoMver. 1002 would be an absolute address in 
memory, not a relative location In the program buffer. 

""ha ^Ue modification process applies to Image (BIC or BIN) 
f'les only. The process, briefly, consists of the following 
steps: 

:. Load the f le nto the program buffer with the LOAD 
command* 

2. Change the size of the Image. If necessary, with 
the HI COPE and LOCOPE commands. 

3. Modify the contents of the desired locatIon{s) with 
the HDD command. 

4. Hodify the transfer address. If desired, with the 
XFR command. 

5. Ur'te the mage onto media with the DUHP command. 
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TKt Modification coMands are: 



CLP clear UPDAT program buffer 

LOAD load a program 

MOO modify file image in memory 

X^R aet transfer address 

HICORE set upper memory limit for dump 

LOCORE set lOMer memory limit for dump 

DL^ dump a program image 



4.1.2.S Nbh fladiw CfMtion 

"he folow'ng commands are used to create new XXDP media. 

bu*ld process 's described in detail in Appendix E of 
th's manual. 

''He n«M med'um creation commands are: 

ZERO 'nitiallze a medium 

CREATE save a monitor on a disk or tape 

COPY copy entre medium 



4.1.2.4 HiMllMOua Cnmm^ 

*^He foUoM'ng are miscellaneous commands: 

A5G assign a logical name to a device 

DO execute an indirect command file 

READ read a file to check validity 

EOT Mr'te logical end-of-tape mark on a tape 

DRIVER load a device driver 



4.1.2.5 Iteturaifit to Nanitor CommniB 

^he following two commands allow you to return control to 
t^e mon'tor: 

BOOT bootstrap a dev'ce 

E/IT return control to the runtime monitor 
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4«1.2.6 ^intint CoM^<i 

Th«r€ are tMO coMsnds to output textual information from 
files. 

PRINT print a file on the line printer 
T>PE type a file on the console terminal 



4.2 CiMwii 

The detailed descriptions 
alphabetical order. 



of UPDAT commands follow, in 



S^Q 0083 



XXOP Us€r'$ Guide liPDAT 



Page 4-6 



4.2.1 ASG Co—in < 

The assign co«Mand is used to assign a logical unit number 
to a device. The device can then be referenced by this 
nuMber in ensuing UPOAT coRMiands. 

The format of the command is: 

ASG dev:«n 



dev * device to be assigned 

n - logical unit number (0-7) 

The primary use for the assign command is to facilitate the 
uM of the 00 command and Indirect command files (see next 
section). 

Example of assign command: 

ASG 0YO:*O 

PIP 0:»OY1:*,CCC 

FILE Oi-MMO: FILE. NEW 
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#.2.2 MOT Cmmmt 

TK« bootstrap coMKarvd is usad to start the monitor in the 
saM Manner as the hardware bootstrap. The purpose of this 
coMiand is to alloM you to boot a device other than the 
ori9*nal system device. The booted device is noN the system 
device. 

The format of the command is: 
BOOT dev: 

The device must have a bootable medium mounted. The boot 
process consists of load i no the first physical block (boot 
block) into the first 256 Cdecimal) words of memory and 
starting execution at location 0, 
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TK« clear coMRsnd clears the program buffer into which 
programs are loaded for modification. This command allows 
the user to assure that unused locations in a program are 
set to zero when the program image is dumped to a medium. 

The format of the command !s: 
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4.2.4 COPY t^mmt 

The copy coMiand !s used to copy the entire contents of one 
Medium to another identical inediun (e.g.: RP06 to RP06). 
The copy process can take two forms. The first is an ''image 
copy". This is a block -for -block transfer and is very fast 
since all available memory is used as a buffer. If the 
device is a bad block device* there is a chance that a bad 
sector may be encountered during the copy process. In this 
case the process is aborted. You then have to use the 
second form, "file copy". This is slower since only one 
block is transferred at a time. In both cases, the former 
contents of the medium are destroyed. There is no check for 
medium type and customer data could be lost. Be careful! 
There Mill be a warning messaoe as shown below. The copy 
will proceed only if a '"'Y"" Ts typed. 

The format of the command is: 

COPY devoz'devi: 



USER DATA ON devo WILL BE DESTROYED! 
PROCEED? (Y/N/CR*N) 

Mhere devo and devi are the output and input devices 
respectively. The two devices must be the same type. Both 
dev'ces must be onl'ne and the output device must be 
write -enabled. 
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4.2.5 CREATE Co— «n< 

'^he create command is used to place a bootable monitor on a 
medium. The command places the appropriate secondary 
bootstrap on the boot block and places the monitor file on 
the medium in a predetermined section. Refer to Appendix E 
for details on building XXOP media. 

The medium need not be Initialized Hith the zero command if 
the medium is already XXDP compatible. In this case only 
the monitor and bootstrap on the medium prior to the CREATE 
operatior. are lost. All other files are preserved. 

The format of the create command is: 

CREATE dev: 

dcv: *s the device with the medium that is to be made 
bootable. The device must be online and 
Nrite -enabled. The file XXDPSM.SYS and the 
appropriate driver must be on the system device to 
build the monitor boot block image. 
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4.2.6 OarrE Co— >nd 

The DELETE coMiand !s used to reinove a file, or files, from 
an XXDP iiediuM. The actual process for deletion Is to 
remove the file name from the directory and deallocate the 
physical blocks used by the file. 

The format of the command is: 

DEL dev:ifile[/N][/Q] 

dev - device where file resides; device Is assumed to be 
online and Nr I te-enabled; there Is no default 

'file flle(s) to be deleted; file must be on dev* e 
specified; extension must be specified (unless 
file has no extension); wildcards are accepted 

/N - Inhibit printing of file names as they are deleted; 

If switch IS not specified, names will be printed 

/Q - do not rewind before searching for flle(s) (tape 

devices only); if switch Is not specified, tape 
will be rewound prior to searching for each file 
to be deleted 

Examples of the delete command: 

DEL WM0:XYZ001.TXT/Q 

This command deletes the file named "XYZ001.TXT'' on flMO. 
^he search for the file begins at the point where the tape 
*s currently positioned (the no rewind switch has been 
specified). An error Is reported if the device is not 
online and wr ite-enabled or If the file does not exist. 

DEL *.OLD 

This command deletes all files on the system device with 
"OLD" extensions. An error Is reported If the device is not 
online and wr Ite-enabled or if there are no files with "OLD" 
extensions. 
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4.2.7 OIR Comm4 

The OIR co#«iand is used to obtain a directory, or list, of 
files on a specified medium. You can specify Hhere the 
directory is to go (console terminal, line printer or file) 
and Mhat form the directory is to take (long or short). 

The format of the command !s: 

OIR [[devo:][ofile][/Q]«][devi:][ifile][/Q][/F][/B][/L] 

devo - output device; default is console terminal unless 
ofile is specified or the is used, in Mhich 
case tl^ie device is default; device is assumed to 
be online and Mr ite- enabled 

ofile - name of file for directory (dfsvo must be a 

file-structured device): defeult is OIR. TXT; if a 
file already exists Nith the specified name, it is 
autodeleted 

/Q - do not reNind output medium prior to beginning 

directory search for file with same name as ofile 
(for tape units only); rewind if SMitch not 
specified 

devi - device from which to take directory; system device 
is default; device is assumed to be online and 
ready 

if He ' files to be listed in directory; wildcards are 
legal; default is • 

/O do not rewind input medium prior to starting 

directory operatIor> (tape devices only); rewind if 
switch not specif i'fd 

/F - give short form of directory; long form if switch not 
specified 

/B - list number of free blocks left on input medium 
(random access devices only) 

/L - send directory to a line printer (parallel printers 
only) 

There are samples of both forms of the directory on page 16 
of this manual. Examples of the directory command: 

OIR OYO:OISK.TXT'MriO:/Q - The directory of files on MHO 
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OIR -0R1:.BIN 

OIR 
DIR » 

OIR OYO:/F/L 



is written into a file called 
"OISK.TXT" on OYO. The tape 
is not rewound during the 
operation. 

- A directory of all files with 
"BIN" extensions on ORl is 
written into a file called 
"DIR. TXT" on the system 
device. 

- A directory of all files on 
the system device is typed at 
the console terminal. 

- A directory of all files on 
the system device is put into 
a file called "DIR. TXT" on the 
system device. Please take 
note of the effect of the 
equals sign on the operation 
of the directory command. 

- A short form directory of all 
files on DYO is printed on the 
line printer. 
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4.2.8 00 CiMWi 

Th€ do coMMK%d !• used to €X€Cut€ an Indirect coMnand f!lc 
for UPOAT, This file is • t€xt file that contains one or 
«ore CO wands executable by UPOAT Nith the exception of 
EXIT. You can create a coMand file that accomplishes some 
coMon task such as building new media. This saves time and 
effort Since you need not enter each command by hand. 

The format of tne command is: 

00 file.ext 

The specified file must be on the system device, therefore 
you cannot specify a device. 

There are tuo functions available in the indirect command 
file In addition to the normal set of UPOAT commands. 
^Irst, any command line beolnning with a semicolon (;) Mill 
be treated as a comment. That Is. no action will be talcen; 
the line Is merely printed. Second, a command line 
beginning Mith a dollar sign ($) mIII also be treated as a 
comment, except the processing of the command file will 
cease after the line Is printed and resumed when a "Control 
X' *s typed. (Control X Is typed by depressing the X key 
MhUe holding the CTRL down.) This second function can be 
used to stop activity while the operator performs some 
reau'red task such as mounting a new medium or placing a 
devce online. 

The file can be made more global In scope by using logical 
un't numbers Instead of device names In the commands. The 
user can then assign logical unit numbers prior to using the 
'nd'rect command fjle using the assign command. The example 
below Illustrates the combined use of the two commands. 

Sai^le Command F'Ue: PHBLO.TXT 

"im i: 

CREATE DRl: 
FILE l:-0:t.SYS 
FILE 1:«0: UPOAT. BIN 

The above file can be used to build the XXOP System on any 

using ar.y other /XOP medium. (Note that the command 
line conta'ning a * <' only Is required to verify the zero 
process. See the zero command description.) The process for 
Oo'ng this "s: 
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ASG DRZi'l 
ASG MnO:-0 
00 RMBLO.TXT 
EXIT 

Th« underlined portion of the above example is that typed by 
L<POA"'. The remainder is typed by the user. 
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4.2.f ORIVCII CiUPi 

Th« dr*vcr coMiand !s used to explicitly load a read/write 
otv'ce driver into i»e»ory. Up to two drivers may be loaded. 

a t^^Ird driver is loaded, one of the drivers currently in 
«e«ory Mill be lost. If a requested driver Is already in 
«ie»ory. no action is taken. 

format of the coMiand Is: 

DfflVER dr;ver[/dr;ver] 

Driver Is the two character device name (e.g.; DY « RX02). 

''he I'st of supported devices and their names Is In Appendix 
C. Note that two devices may be specified with one command. 

DRIVER OY:/OK: 

"^he purpose of the driver command Is to alloM a user to 
Pu'ld XXDP media with limited resources. If the system 
dev'ce *s required for building a new medium, the user can 
load the drivers required, remove the system medium, mount 
the ^ew med'um and buUd XXOP. 
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TK« du«p coMiand Is used to write the prooram Image in the 
prograiR buffer Into a file on a inedluM. The image size is 
deter* ned by the upper and lower memory limits displayed by 
the HICORE and LOCORE commands. A transfer address will be 
put *nto the file. This address can be examined and altered 
w'th tha XFR command. 

'^he format of this command is: 

01^ [dev:]ofile[/Q] 

dew - device to which file is to written; default is 

system device; device is assumed to online and 
write -enabled 

of'le - file name for binary file; wildcards are not 
accepted; file with specified name must not 
already exist on device 

/C - 'nhiblt rewind before searching for logical 
end-of-tape (tapes only) 
Examples of the dump command: 

OUM> 0Y0:ZRlAA1.BIN 

*^he program image is written to OYO and given the file name: 
'ZRlAA1.BIN". 

DUWP FILE3.BIC 

'^he 'mage is written to the system device and given the 
specified name. 



E8 



SEQ 0095 
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4.2.11 COT Cdiw< 

The EOT coMsnd is used to place a logical end-of-tape 
marker on a tape at the current position. Note, the tape is 
not reiiound. All files after the current position will no 
loo9er be accessible. The narker consists of two 
consecutive tape marks. Any data beyond this point on the 
tape is lost. 

The format of the command is: 
EOT dev: 

The device must be a tape unit. The system device, if a 
tape unit, is the default device. 
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4.2.12 CXZT Cmmmi 

TK« txit ce«Mand used to r«turn control to th« runtime 
•on Iter. 

Th« format of th« command ••: 

EXIT 



G8 



SEO C097 
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4.2.15 taCORE Cowwd 

The HICOAE commmnd Is used to alter the address of the 
h'ghest virtual iie«ory location that is transferred durino a 
dump' ooeration. The default location is printed after the 
LOAD coMiand. 

The format of this coiMiand is: 
HICWE 

The address of the highest virtual memory location to be 
used during a dump operation is printed. UPDAT waits for 
you to alter or accept the location. You can enter a new 
locat'on by typing the octal address or accept the given 
location by typina a "carriage return''. This address must 
be above that of the lowest virtual location (low core) and 
beloM that of the top of the program buffer. 
Examples: 

HICORE 
40000 45000 

This coNimand changes the upper virtual location from 40000 
45000, 

HICORE 
100000 (CP) 

This comnand allows the upper location to remain as 100000. 
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4.2.14 Lottd Cp— lij 

The losd conMand used to load a binary file into memory 
for tHe purpose of modifying the program image. As the file 
is loaded, a checksum is computed and compared with a 
checksum stored with the file. 

The command format is: 

LOAD [devi:];f;ie[/N][/Q] 



dev' • device from which to load the files default is the 
system device; device is assumed to be online and 
ready 

'file - file to be loaded s no default accepted 

/N - inhibit printing of upper and lower memory limits and 
file name found (if wildcard used) 

/Q - Inhibit rewind before searching for file (tapes only) 

UUdcards are permitted in the file specification, but you 
should be careful when using them. The data In the program 
buffer Is the result of the overlays of each file found. 
The program buffer Is not cleared between loads and the 
unused locations for the last file loaded does not 
necessarily contain zero's for contents. The wildcard 
feature Is really only useful for doing file sanity checks 
to verify that files are not corrupted. 

After the load is successfully completed. UPDAT prints the 
transfer address and core limits (the lowest and highest 
virtual memory locations used by the program). These 
parameters can altered by the user as described In 
subsequent command descriptions. Example: 

LOAD DYO: PR0G1.BIN 

XFR: 000001 CORE: 000000.020000 

Th's command is also used to load an XXDP monitor image into 
the program buffer. This must be done as part of the media 
bj'ld process. The section on New Medium Creation earlier 
*n th's chapter and Appendix E on Building XXDP describe 
th's process. 
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4.2.15 LOCORC Co— n< 

The lOCORE comnand is used to alter the address of the 
lowest virtual incnory location that is transferred in a dump 
oocration. The default location is printed after the load 
oocration Is coiipletcd. 

The format of this command is: 

LOCORE 

Examples: 

LOCORE 
000200 0 

This command modifies the low memory address to zero. 

LOCORE 
000000 20 

This command raises the low memory address to 20 (octal). 
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4.2.16 Modify Cowid 

The modify coMomd is used to alter the contents of one or 
more virtual memory locations !n a program that has been 
loaded by UPDAT. 

The format of the command is: 

MOO nnnnnn 

nnnnnn is the octal address of the virtual memory location 
whose contents are to be modified. 

UPOAT responds by typing the address and the current 
contents. It then waits for you to either type new contents 
or accept the current contents by typing a "carriage 
return*. If you wish to modify, or examine, two or more 
consecutive virtual memory locations, you type a "line feed" 
after modifying each location. 

Examples: The following command modifies virtual memory 
location 2460: 

MOD 2460 

002460 770 771(CR) 

The following command examines but does not modify virtual 
locaton 12004: 

MOD 12004 

012004 012736(CR) 

The following command modifies two consecutive virtual 
memory locations (1220 and 1222). 

MOD 1220 

001220 120 167(LF) 
001222 120 1234(CR) 
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4.2.17 PIP m4 FILE CoMsnrts 

The PIP snd FILE coMsnds are used to transfer a single 
file, or Mltiple files, frow one medium to another. There 
•re two differences between these commands: 

1. The FILE command allows autodelet Ion; the PIP 
command docs not. 

2. The PIP command lets you specify an output file 
name; the FILE command docs not. 

Autodelet Ion Is simply the removal of a file from the output 
medium If It has the same name and extension as the file 
being transferred. If you attempt to transfer a file when 
the name already exists on the output medium using the PIP 
command, the file Is not deleted, the transfer does not 
occur and a warning messaoe Is printed. If several files 
are being transferred, only those that do not have names and 
extensions that match already existing files on the output 
medium are transferred. If a FILE command is used, all 
files are transferred reoardless of what files exist on the 
output medium and any files on the output medium that have 
names and extensions matching those of files being 
transferred are deleted prior to the transfer. The operator 
Is not notified of autodelet Ions. 

The PIP command may be used to rename a file during the 
transfer process since output file specifications are 
allowed. The FILE command never accepts output file 
specifications and files will retain their names and 
extensions as they are transferred. 

The format of these commands are: 

PIP [devo: )[of Ile][/C]-[devi : ][ if ile][/Q][/N] 
FILE [devo:][/Q]=[devi:][Ifilel[/Ql[/Nl 

devo - output device: system device Is default; device Is 
assumed to be online and wr Ite-enabled 

of He - file name for output file; wildcards are 

permitted. In which case the input files will be 
renamed to match the output specification (please 
refer to the examples below); default Is .t if 
file already exists on output device, transfer 
will not occur; NOT USED WITH FILE COMMAND 

/Q - do not rewind output medium prior to directory search 
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for already existing file (tape devices only); 
rewind after each file if switch not specified 

devi - Input device; default is system devices device >s 
assumed to be online and ready 

'f*le - input file name; wildcards are permitted; default 
is .1 file(s) specified must exist 

/Q do not rewind before directory search for first file 
(tape devices only); rewind if switch is not 
specified 

/N - do not type name of each file as it is found; type 
each name if switch is not specified 

Examples of the PIP and FILE commands: 

PIP 0Y0:NEU.BIN«DR1: ZZZZZZ.BIN 

This command copies the file "ZZZZZZ.BIN" from ORl to 
"NEW. BIN" on DYO. The transfer does not occur if "NEW. BIN" 
already exists on DYO. 

FILE DYO: -DRl: ZZ1ZZZ.BIN 

The file "ZZZZZZ.BIN is transferred from DRl to DYO. It 
replaces a file of the same name on DYO if such a file 
exists. 

PIP «DDO:XHONCO.LIB 

The file "XMONCO.LIB" is transferred to the system device 
from DDO. The name is not changed. If "XnONCO.LIB" already 
exists on the system device, you are given an error 
'nd' cat ion and the transfer does not occur. 

FILE «000: XMONCO.LIB 

This command has the same effect as the command in the 
previous example except that if "XnONCO" already exists on 
the system device, it is deleted prior to the transfer. 

PIP 0U1:«0U0: 

All files on DUO are transferred to DUl. Any files that 
already exist on DUl are not transferred and you are 
notified. The remaining files are transferred. 
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FILE DU1:-DU0: 

In this case all files on DUO will be copied to DUl. 
regardless of what files already exist on DUl. This command 
provides a convenient utethod of putting updated files onto 
an existing XXOP Medium. 

PIP MM0:FILE77.«» 

All files on the system device will be transferred to MMO 
and RENAMED to have the characters "FILE" replace the first 
four characters of the original name. Be careful if you use 
wildcards on the output specification! 
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4.2.1t PtINT Cnmnnt 

Th« print coMiaod ts used to read textual information from a 
flla and output !t to a line printer. The file must contain 
text in ASCII format. 

The format of the command is: 

PRINT [dev:]ifile[/Q] 



dev - device where file is located: default is system 
device; device must be online 

If He - file to be printed; must exist and contain text 

/Q - do not rewind before searching for specified file 

Ctape devices only); rewind will occur if switch 
is not specified 

Exanole: 

PRINT Mril:HELP-TXT/Q 

^h*s command reads the file 'HELP. TXT" from the tape on Mtll 
and pr'nts It on the line printer. The search for the file 
bcg'ns at the current tape location; no rewind occurs. 



XXDP Us«r s Guide UPOA^ 



Pa9€ 4 28 



4.2.1f REM) CBMtnii 

Th€ rt»d coMiand is uMd to check device and media 
'ntegr'ty. Each block of the file specified in the command 
tt read into memory and a checksum is calculated. The 
computed checksum is compared to the checksum stored with 
the file. 

*he format of the command is: 

READ [dev:]ifile[/N][/Q] 



dev * device from which f ile(s) are to be read;default is 
system dev'ce; device must be online 

'f'le - flle(s) to be read; wildcards are accepted 



/N - do not print name of each file as it is read 

/6 - do not rewind before searching for specified files 
(tape devices only); remind mill occur !f smitch 
's not specified 
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SEQ 0107 




rt^aMt commmr^ '% us€d to cHsngc th« file specif lest ion 
o^ er €x*tt>9 file without doing • transfer. The naii»e of 
t^ ^'le M recorded 'n the directory is chenged, but there 
s •^o woveeient of dete. 

*^e *o^«et of the coMond 's: 

^CN :dev:]ne«ineiii>[dev:]oldneiii 



oe^ oev ce Mh«re f 'le to be rcneined exists; default is 
system device; dev'ce Is assumed to be online and 
Mr *te -enabled; dev'ce i^ust oe saaie for both Input 
and output 

'^eii^ap ♦ new file soec'f Icat on; f*le w'th saute 

soec'f Icaton must not evist on device; wildcards 
are accepted 

oldnam - current f*le spec If 'cat Ion; f*le «iust exist on 
dev'ces wildcards are accepted 
rxawples of the r e na^i e co— and; 



•^EN D'::DIftG.3LD-DTl:DIAG.BIN 



^r 's CO— t, 

::-3.2:s. 



land r^ni 



IS to the f 'le DIAG.OlO on 0X1 to 
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4.2.21 Vm Cmmn4 

tyot coMK^nd !• uMd to r«»d textual Information from a 
f *Ie and output it to the console terminal. The file must 
conta'n text ;n ASCII format. 

The format of the conMntf Is: 

TYPE [dev:]if;ie[/0] 

dev device where file Is located; default Is system 
device; device must be online 

*f'Ie * file to be typed; must exist and contain text 

* do not rewind before searching for specified file 
(tape devices only); reuind m'11 occur If snitch 
is not specified 

Example: 

TYPE SYSTEH.CCC 

''he f*le -S^STEH.CCC'' Is be read from the system device and 
pr'nted on the console terminal. 
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4.2.22 m CpMWi 

TK« XFR coM«nd IS us€d to modify the transfer address !n 
tK« protfrsii that has b€€n loaded. The file created by the 
DUMP co—and will have this transfer address. This is 
address of the location to »«hich control will be transferred 
Mh«n the program is Started. 

After you enter this coMnand. UPOAT prints the current 
trer^sfer address. If you don't wish to alter the transfer 
address, you should iMned lately type a "carriage return". 

for«at of the coMand is: 

XFP 

Examples of this coMand: The following coiMRand changes the 

transfer address fro* 200 (octal) to 1000 (octal): 

XFR 

000200 001000 

^he following coMand examines, but does not change, the 
transfer address: 

XFR 

002000c cr: 
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4.2.2S ZEUO 

The zero coMnand initializes a medium by clearing the bit 
map (random access devices) or writing an end-of-tape mark 
^sequential access devices) and placing an empty directory 
on the medium. 

CAUTION: 

all data on the medium prior to a zero operation is 
irretrievably lost after the operation. UPDAT makes 
no attempt to determine what is on a medium and will 
destroy customer data. 

A warning is printed whenever this command is invoked* 
stat'ng which device Is Involved. You must then verify that 
the zero operation is to take place. 

''he ^cmat of the zero command is: 

ZERO dev: 

"^here Is no default for the device. The device must be 
online and write -enabled. The following warning will be 
Issued after the command Is entered: 

USER DATA ON dev UILL BE DESTROYED! 
PROCEED? (Y/N/CR-N) 

The only answer that will confirm the user's intent to carry 
on Is "Y". 

There will be an additional warning message if you specify 
the system device In the ZERO command. 

ZERO SYSTEM DEVICE 

YOU riAY NEED AN ADDITIONAL DBIVER 

PROCEED? (Y/N/CR-N) 

If you wish to proceed with the process, you must type a 

The meaning of the warning is that you must assure the 
presence in memory of two drivers, one for the system device 
and one for the device from which files will be moved to the 
new med'a In the system device. To assure that the 
necessary dr'vers are In memory, use the DRIVER command. 
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4.S Sm»1« Notfification 

Th« folloMing saaplc file Modification illustrates the use 
ot* UPCAT coMiands. It is based on the following patch for a 
f'ct'tious diagnostic naaed ZXXXBO.BIN: 



Location Old Contents New Contents 



Th« UPOAT dialogue used to accomplish this is shown below. 
Th« underlined portion is that typed by UPOAT. (LF) and 
(Cft) refer to line feed and return. 



*R UPOAT 

Cbupseo am ueodi uiiiin 

eESIARI AQQRESSi 
LOAD ZXXXBO.BIN 

nOD 1224 



HOD 1452 

Q01452 QQQ326 374(CR) 
MOD 1452 

00i452 50Q324 (CR) 
01^ ZXXX61.BIN 




106701 
177660 
576 



240 
240 
374 




MOD 1224 




The user examines locations previously modified in order to 
^er'fy the changes. The user also renames the file to 
reflect th« pstch level. 



CHAPTER 5 
PATCH UTILITY 



"'he PATCH prooraM can be used to modify any binary formatted 
(.BIN or .6IC; file stored on an XXOP storage medium. It is 
an alternative to the LOAO-flOO-OUnP sequence of UPOAT. 



S.l OMcription 

PATCH sHould be used in the following instances: 

1. You are modifying a file that is too large to be 
loaded into tne memory space of your system. This 
situation precludes the use of the LOAD-flOD-DUMP 
sequence of the update programs. 

2. You are modifying OEC/Xll runtime exercisers. (It 
Is assumed that reader is familiar with OEC/Xll 
usage. If not. please read the OEC/Xll User Manual 
before attempting to use PATCH on this software.) 
As these programs CAMNOT be patched using the 
update programs, you must use this program if you 
wish to produce a permanently modified .BIN file 
for a DEC/Xll PTE. 



000^0 ******** 

Notice 

The DEC/Xll features have 
not been fully implemented in 
DEC/Xll monitor. Please 
patch PTE's with this 
as you would any other 
binary file. 

^t******* *********************** 



19 



SEQ 0112 



J9 
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SEQ 0113 



5.1.1 Starting PATCH 

0|>€ration of this program consists of tHO phases. The first 
's the building of a table containing the modifications that 
Will be made to the file in question. This table is 
referred to as the '♦input table". You fill this table with 
the addresses you wish to modify within the file, along with 
the desired contents of these addresses. This table may 
then be saved as a file and retrieved for later use. The 
second phase of operation is the combining of the 
'nformalion contained in the input table with the actual 
binary f Ue to produce a new, modified file. The original 
file is not modified by the program. 

In order to load and start this program, you must type the 
following command to the XXOP monitor: 

PATCH 

Th*s command causes the PATCH utility to oe loaded into 
memory and begin executing. The program identifies itself 
w*th the message: 

CHUPA?? XXDP PATCH UTILITY 

The program then prompts for your input with the 

character. At this point you can begin entering commands to 

the program. 



The valid commands for PATCH are: 



BOOT 

CLEAR 

EXIT 

GETM 

GETP 

KILL 

MOD 

PATCH 

SAVP 

TfPE 



Boot specified device 

Clear input table 

Return to XXDP monitor 

Load DEC/Xll MAP file 

Load saved input table 

Delete address from input table 

Enter address in input table 

Create patched file 

Save input table 

Pr'nt Input table on terminal 
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In or^p to patch a file MitH this p^'ogram you must perform 
two operations: 

1. You must build an input table containing all of the 
addresses which you wish to modify within the file, 
along with the contents you want these addresses to 
have. The input table may have a maximum of fifty 
(50) of these entries. 

The commands you may use to build the input table 
are: 

CLEAR 
GETM 

noo 

TYPE 
KILL 
SAVP 
GETP 

These commands are described below. 

2. After you have completed the input table you must 
use the PATCH command to add the address 
modifications within the Input table to the file 
you want to patch. The PATCH command is described 
below. 

It 's Important to note that the file you are modifying is 
never completely loaded Into memory. 
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5.2 PATCH Cvmm^ 
5.2. 1 BOOT 

Th« BOOT com w snd boots the specified device. 
The for*«t is: 

BOOT [dev:)<CR> 
The default device is the system device. 



L9 



SEQ 0115 
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5.2.2 ae/m 

The CLEAR eonnand clears the input table of all entries. 
The command format is: 
CLEAR 



M9 



SEQ 0116 
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5.2.3 EXIT 

The EXIT comiMnd returns control to the XXOP monitor. 
The conmond foranat is: 

EXIT 



N9 

SEQ 0117 



I 
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S.2.4 GETfl 

This CO — uMd only Mh«n patching DEC/Xll runtime 
«*««rcl««p«. It retrieves • DEC/Xll "MAP" file of the 
•pccified filenaM fro« the specified device and loads it 
into wmmory (Me MCtion: "OEC/Xll MAP FILES"). 

The ce«Martd f«rwmt 

GETM (dev:]filna«.ext 

default dcv'ce is the system device. 
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6ETP 



Th« G£TP coMiand causes the input table to be loaded with 
tHe contents of a file that was created using the "SAVP" 
coMiand. Execution of this cofMiand causes any previous 
contents of the input table to be lost. 



The coMand format is: 

GETP [dev:]fiIna«i.ext<CR> 
''he default device Is the system device. 



CIO 

SEQ 0119 
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S.2.* lOU 

"^H* CO W is uMd to dtlctt an entry from th« input 

tabic. 

Th« CO— a n d format is: 

KIU *mMr> 



DIO 

3E0 0120 
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5.2.1 NOD 

Th« hOO coiMRftnd Is used to enter an address and the desired 
new contents of that address nto the input table. The MOD 
coMRar>d has two «odes of operation, depending on whether you 
are Aodifying a OCC/Xll RTt or another type of binary file. 
These tMO «odes are described n the following sections. 



5.2.7.1 lifiwY (NON OEC/Xll) Natfa 

Uhen used »»'th b'nary files other than OEC/Xll RTE s, the 
^or«at of the noo coimand is: 

HOD addr 

itfhere addr is any valid 16-bit address. Lead'ng zeros 
can be omitted. 

After you press carriage return to conclude the coMiand* the 
requested address is retyped, followed by a slash. If this 
address has not been previously entered in the input table, 
the slash Is followed by si« dashes* (Because the file you 
M'sh to Modify is not in Me«K>ry. there is no way of know i no 
the current contents of the location you have specified.) If 
the address has been Inserted into the Input table, the 
previously entered contents of the address are typed after 
the slash. 

nOD 123456 

In th's exaaple. the operator has specified phys'cal address 
123456 to be modified, '^he dashes Ind'cate that th's is the 
f>st t'Me th*s address has been specified. 

ExaiKpIe: 

In th's case an actual value appears after the slash. This 
'nd'cates that the operator had previously entered this 
address nto the Input table and had specified the new 
contents of the address to be 000240. 

^t t^'s po'nt you can t^pe the yalje you w'sh to have loaded 
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*nto tH*s address. Th's v«1l»« can b€ any octal nmnbar from 
0 to 1^7777. Ltading ztro s may be o^itttd. Afttr tntering 
t^« valut* vou can type t'thar a <CR> (carriaot return) or a 
<lP> (Tne ^eed). A <CR> closes the table entry for 

this address and causes a prompt to be printed so that 
another co— and can be typed. A <LF> closes the current 
table entry and nakes a new entry for the next addressable 
•esiory location (I.e. <addr>«2). The new contents for this 
address can then be typed. 

Exan^le: 

nOO 1254S6<CR> 
12S4S6^iiiiii 000207<CR> 

In the evaftple, the operator has specified that location 
123456 should contain 000207. The carriage return closes 
the 'nput table entry and causes a prompt () to be printed. 

Exan^le: 

noo ii04o<CR> 

Qil04Q^00Q24Q 000137<lf> 
051502<CR> 

In th*s case the operator has re -opened the table entry for 
address 11040 . changed the contents to 000137, and typed a 
<lF> to aake a table entry for location 11042. The dashes 
'nd*cate this location had not been previously entered into 
the table. Th's location receives a contents of 51502. then 
a <CR> 's typed to close the table entry and cause a prompt 
to be pr'nted. 



5.2.7.2 OCC/Xll Hada 

•Jher Morklng with 0£C/X11 files, the coNMiand has three 
o'^ferent formats, as follows: 

nOD addr 

HOD nOH iiodnam addr 
HOD opmod addr 

^orm (1) of the HOD commend Is the same for OEC/Xll usage as 
't 's for non-DEC/Xll usage (see previous section), with the 
exception that 18-bIt addresses accepted. 

Forms (2) and (3) of the HOD command allow the operator to 
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so€cifiy locations Mithln a OEC/Xll runtime exerciser (PTE) 
by typing the name of a Monitor module or option module 
followed by an offset into that module. These forms of the 
command may be used only if a OEC/Xll "map" file has been 
retr'tvcd by means of the GETM command (see section: 
•OEC/Xll MAP FILES"). 

^ormat (2) is used for modifying locations within monitor 
modules. An example of this format is: 

nOO nON KTERR 24<CR> 

^he keyword HON is used to indicate that the module is in 
the monitor section of the PTE. In this case the operator 
*s specifying location 24 relative to the beginning of the 
monitor module named "KTERR". 

Format (3) is used for modifying locations within option 
modules of exercisers. Opmod is the name of the option 
module to be modified. The name has five characters, the 
fifth character being the copy number (the first copy is 0). 
An example of this format is: 

nOO CPBJO 100<CR> 

Th« operator, by typing this command, is indicating that he 
washes to modify location 100 relative to the beginning of 
the first copy of option module CPBJ. 

In all three formats, after t^e <CP> is typed the actual 
physical address being referenced will be typed, followed by 
a slash (/). If this address has not been previously 
entered in the input the slash will be followed by stx 

dashes ( ). If the address has already been entered in 

the Input table, the previously entered contents of the 
address will be printed after the slash. 



Exai^le: 

mo 012546<CP> 

In the example, the operator has specified physical address 
12546 to be modified. The address is rtt^o^d. followed by a 
slash. The dashes Indicate that this is the first time this 
address has been spec 'fed for modification. 

Example: 
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NOD MON KTERR 10 <CR> 

In th's case the operator has specified an address Nithin 
th« monitor section of the PTE and has done so by using a 
Module naae. Notice that the program determines the actual 
physical address represented by the command string arguments 
and prints that address. Here an actual value appears after 
the slash. This indicates that the operator had previously 
entered this address into the input table and specified neN 
contents of 000240. 

At this point vou can type the value you wish to have loaded 
into the spec 1 tied address. This value can be any octal 
number from 0 to 177777. Leading zeros can be omitted. * 
After entering the value you wish, you can type either a 
carriage return or a line feed. A <CR> closes the current 
table entry and causes a prompt () to be printed so that you 
can then type another command. A <LF> closes the current 
table entry and makes a new entry for the next addressable 
memory word (I.e., <addr>«2>. You can then type new 
contents for the address. 

Example: 

»100 012546<CR> 

12546^. -i-r- 000207<CR> 

In the example, the operator has specified that location 
12546 should contain 000207. The <CR> closes the input 
table entry and causes a prompt to be printed. 

Example: 

NOD HON KTERR 10<CR> 

In this case the operator modified the contents of the 
location 7126 so !t will be 000137 (he had previously 
specified that this address should contain 000240). He then 
typed a <LF> to close the table entry for address 7126 and 
to create a table entry for location 7130. The dashes 
'nd I cate that tnis location had not been previouslv entered 
*n th€ table. This location received a contents or 51502 
and a <CR> was typed to close the table entry and cause of 
prompt to be typed. 
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5.2.9 MTOH 

After tH« device address modifi cat ions have been entered in 
the input table, a new output file containing these 
nodi t icat lons can be produced with th« use of the PATCH 
coMsand. This co—and reada the specified input file, adds 
the address iModif icat ions contained In the input table, and 
builds a new output file having the specified file nanie. 

The fornat of the coMsand is: 

PATCH (dav:]f;ina«.ext-[dav:]f;inaiii.ext<CR> 

The default device (input and output) ia the system device. 
The input file and the input table are unaffected by the 
execution of thia coMsand. 

An exaiiple c o t ia nd string is: 

PATCH DYl : SAMPLE . BIN-DYO : SAHPL 1 . BIN< CR > 

This coMnand takes the file SAHPLl.BIN located on device 
DYO. combines it with the address modifications in the input 
table, and produces a new file on device DYl called 
SAriPL2.BIN. 

After you press the carriage return to conclude the coMiand, 
the following instruction is printed: 

IF THIS IS DECXll TYPE THE MONITOR TYPE. ELSE JUST <CR> 

If you are patching any file which is not a DEC/Xll runtime 
exerciser, then type a <CR>. If this response is typed, the 
program begins construction of the output file. When 
execution is completed, the message "DONE" is printed, 
followed by a prompt. 

If you are patching a DEC/Xll runtime exerciser (RTE). you 
must respond to the printed question by telling the program 
the type of monitor contained in the RiE. There are three 
methods for determining the monitor type of the RTE: 

1. Run the DEC/Xll configurator/1 inker program and 
type the configuration file for this RTt. if it 
ex'sts. 
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2. Run the OEC/Xll configurator/linker program and 
typ« th€ MAP file for this PTE. if it exists. The 
men t tor type appears at the top of the listing. 

3. Run the PTE. The iionitor type is printed at 
start-up tiiie. 

If the iN>nitor of the PTE is one that does not support 
meinor/ Management, the program now begins building the new 
output file. When this process is complete, the message 
DONE" is printed on the terminal, followed by a prompt. 
If. on the other hand, the specified DEC/Xll monitor type is 
one that does support memory management, the program now 
checks to see if a MAP file has been loaded into memory with 
the GETM command. If there is no MAP file in memory, the 
following instruction is typed: 

TYPE MOOQ ADDRESS: 

In order to determine this address* you must look at a 
listing of an appropriate MAP file (see DEC/Xll MAP Files). 
The symbol MOOQ is located within the monitor module 
"CONFIG% so just find the module name "CONFIG" on the 
listing, then look at the symbol names underneath the module 
naMe until "MOOQ" is found. The physical address printed 
next to the symbol "MOOQ" is the address which must be typed 
In response to the question. If a MAP file was previously 
loaded into memory using the GETM command, the program 
automatically finds this address and thus does not ask the 
question. 

Next, the following message is printed: 

IF MODIFYING OPTION MODULES. TYPE LOUEST MODULE 
ADDRESS. ELSE JUST <CR> 

If you are modifyiri only the monitor section of the runtime 
exerciser « the proper response to this message is to simply 
type a <CR>. If you are patch i no both the monitor area and 
one or more option modules* or It you are patching only 
opt 'on modules, you must now type the address of the first 
option module that was linked mto the runtime exercisar. 
Th's address can be obtained in two ways: 

1. If you have a MAP file listing for the proper 
monitor type (see "DEC/Xll MAP FILES"), find the 
first occurence of an option module name on the 
listing and use the physical address associated 
w'th that option module. The option modules are 
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located at the end of the listing. The physical 
address of each module is printed next to the 
ffiodule naine, under the heading "PH AOOR". 

2. Before running the PATCH program, you can load and 
run the PTE that you intend to patch, then type a 
"MAP" coMnand. Tnis command causes the starting 
addresses of all option modules to be printed. For 
each option module, look for the address labelled 
PA:". Find the physical address which is lowest 
(not necessarily the first one printed!). 



After the typing of a <CR> the program will commence 
construction o ♦'he output file. When execution has been 
co«ioleted the fm sage "DONE' will be printed, followed by a 
prompt. 
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5.2.9 SMP 

This coMiand csusss the contents of the input table to be 
saved as a file with the specified filename on the specified 
device. The coMand does not cause any alteration to the 
input table contents* 

The coMand fomat is: 

SAVP [dev:]f:inaiii.ext<CR> 
The default device Is the system device. 
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S.2.10 TYPE 

TK« TYPE coawand causes the contents of the input table to 
be listed on the system terminal. 

Th« cOMnand format is: 

TYPE 



MIO 

SEQ 0129 
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5.3 OEC/Xll NAP Files 

In order to utilize the full capabilities of the HOD command 
when modifying OEC/Xll runtime exercisers* you must have a 
MAP file. 

The HAP file is produced by the OEC/Xll configurator/linker. 
It is the symbol table which is generated at link time and 
saved using the SAVM command. (Please refer to the OEC/Xll 
User Hanual.) Mithout the MAP file the MOO command Nill only 
accept phvsical addresses as arguments, but if a MAP file 
has been retched using the GETM command, the MOD command 
will accept module names (both monitor and option module 
names) as arguments. 

If you are going to modify the option modules of a 
particular runtime exerciser, and if vou wish to be able to 
type the option module name and an offset value when using 
tne command, then you must use the MAP file generated during 
the linking of that particular RTE because the number and 
order of the option modules in any RtE is unique. If you 
don't have the proper MAP file you must manually calculate 
the physical address of the option module's relative address 
and type that value as the MOD command's argument. 

On the other hand, for any given monitor type (A. B. C. 
etc.)* the monitor modules are always linked in the same 
sequence. This implies that if you are modifying the 
monitor section of an RTE and wish to type the monitor 
module name plus an offset when using the MOD command, you 
need not have the MAP file for the particular RTE you are 
modifying. Any MAP file for the proper monitor type will 
do. For example, if you are modifying the monitor area of 
an RTE of a monitor type C. you may use any MAP file Mhich 
was generated when linking any RTE having monitor type C. 
Similarly, the address of MODQ is also the same for every 
monitor of the same type, so if the PATCH command prompts 
you for the address of MODQ. you may look at any map listing 
of the proper monitor type to obtain the address. 

It is important to remember that when a new release of the 
OEC/Xll monitor library is issued, all MAP files generated 
from the previous release of the library become invalid. 
They may not be used when patching files generated with the 
new library. New MAP files must be produced. 
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S.S.I SuwMte^ OCC/Xll Ap»lic«tipA 

UHen a D£PO is issued for a OEC/Xll monitor module, the 
patch must be mdded to every runtime exerciser that is 
generated containing that module (depending on the monitor 
type) If you ere m an environment in which you build many 
PTE's (wsnursctur ing. for example J, it is suggested that you 
build and save an Input table for every monitor type. These 
saved tables can be added to and re -saved every time a new 
0£P0 is Issued. After any PTE is built with the 
configurator /I Inker, simply run this program, get the input 
table for the proper monitor type, add to the table any 
modi f 'cations that must be made to the option modules C using 
the HAP fie If you wish) and then execute the PATCH 
command. 



CHAPTER 6 
SETUP UTILITY 



SETUP 's an XXDP utility that elts you build the hardware 
and software tables for a diagnostic prior to running the 
diagnost'c and store the tables with the diagnostic. 
SETUP has the sa^c nenory requirements as DR5: 5.75K words, 
^he »>'mum size system that can be used !s 2BK words. 



ft.l Startifig SETUP 

To run SETUP, use the XXDP run command. Below Is an example of 
Starting SETlP for use > building XXDP environment diagnostics, 
"^he i^^r lined portions are typed by the system. 

.R SETUP 

SE^^JP Is now ready to accept commands. 



•.2 

"he foIIOMing are the SETUP commands: 

SETUP build tables for specified diagnostic 

LIST type a list of DPS diagnostics on a medlt 

EXI* retjrn control tO XXDP 



Cll 

>ES 0132 



Pmgt b2 



••2.1 LIST 

^:s^ coMian4 UM4 to obtain • list of all 
D^S cc«oot'blo 4i agnostics on s iitdluiii. 

^o^t of tHo co—srd !s: 

wIST [«tv:][f;io.oict] 



Otv * dtvico to sosrcH for 0PS-co«OSt iblo filos; ^fsult 
's the systw dtvico 

f'lo.oxt - fll«(s} to sosrcH; oxttnsion iiust bt BIN or 

BICs MUdcsrd SMCif icst ions sro sccoptodi 0t fault 

;s '.Bi?' 



SETlP CO— and causas tHa soaclf lad diagnostic to ba 
loadad Into Maaory. SETi^ than procassas tha tabla building 
coda In tha diagnostic. You go through tha sa»a procass 
that occurs Mhan actually running tha diagnostic and issuing 
a S^APT COMM. 

^ha format of tha cowand Is: 

SETUP [davo:]of"la«[dav;:]IfIla 

oa«^o - dav'ca to uhlch f Ua Is to ba Mrlttan; dafault Is 
systam davica; davica nust ba on-llna 

of 'la - naM of f Ua for tha diagnostic that has baan 

SETUP WITH .BIN OR .BIC PxTENSION 

oav* - davica froai Mhlch f la Is to ba raads dafault Is 
systam davica; dav'ca must ba on-llna 

'^Ua - nama of f Ua for tha diagnostic that Is to ba 

SETUP 

'OJ can giva tha output file the sama nama as tha Input 
^'la, but you gat a massaoa that warns against the 
acc'dantal loss of tha original flla. Tha massaga Is: 

DE1.ETE -fUa? ^T/N/CP«0 

I' iOj t/oa a <• or no answar at all, tha Input f'la 
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I^'lt Mltttd afttr tht SETUP process and the n«M file 



CHAPTER 7 
XTECO UTILITY 



''h« XTECO (pronounced 'cx-tcc-co") utility is used to create 
and edit (modify) text files. Text files contain ASCII data 
rei^resent Ing valid text. Valid text consists of all 
or'nt'ng characters, tab, carriage return, line feed and 
for* feed. Tne principal text files in XXOP are batch 
control (chain) files. XTECO is a siaple editor, a limited 
subset of the TECO character editor supported by most of 
DEC s operating systems. The commands are few and simple, 
but adeouate for the tasic. 



7.1 OMeriptlan 

Before describing the commands in detail, let's look at some 
base XTECO concepts. To XTECO, a text file contains one 
long str'ng of characters sort of like beads on a strino. 
It processes the file one character at a time. The utility 
can only have a certain number characters in memory, so only 
• segment of the string can be worked with any given time. 
There are special characters (carriage return and line feed) 
that act as signals to XTECO to tell it when one line of 
text ends and another begins. This allows the editor to 
manipulate lines of text as well as characters. The editor 
treeps track of where it is on the string with a pointer, 
'^h'ft pointer Is manipulated by the various commands ano Is 
jsed by XTECO to locate where new text is to be placed and 
old text removed or modified. This pointer may be moved 
back and forth over the portion of the string m memory at 
tne t'me. but cannot go backwards into the portion of the 
str'ng already processed and placed into the new file. Thus 
/ou need to understand two bas'c concepts: text as a string 
of characters and a po'nter to locate the editor on that 
str'ng. 



Fll 

to 0135 
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p^tviously Mf^tiOo«d. or>ly • c«rta*n s«gHitnt of • t€xt 
»ay r«ttdt in Mt«ory at any givtn tiM. XTECO 
proc«tMS f«l«t by r^adin^ • MQMitnt from th« input f!l« 
*nto Mttory, do'ng any «dit functions on that s«9Mnt (as 
d>«ct«d by tK« uMr) and tK«n writing tK« sagiRtnt into the 
output fil«. This process continues until the entire input 
^*le hM been ected upon. In the case of the "TECO" comnand 
Csee next section) where the input and output file may have 
the saM naaie and reside on the $a«ie niedium. XTECO creates l 
temporary output f'le which replaces the input file after 
the ed't process *s complete. 
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7.1.1 Starting ttm Edit Frac#M 

The first thing • u9€r must do after starting XTECO is to 
nitata th« process of editing text. (XTECO is started by 
typing ''R XTECO" in response to the XXDP monitor prompt.) 
There are three commands to do this. 

TEXT - used to create a neN file 
TECO - used to modify a file 
EDIT - used to modify a file 



Each of these commands r>uts XTECO into what is cnlJed "edit 
mode". Uhile in this mode, text inforir'*t ion can be created, 
deleted or modified. There is one difference between the 
EDIT and TECO commands. The TECO command can be used with 
random-access devices (i.e., disks) only and the input file 
name is all that is required. The output file name ias the 
same as that of the input file. An output file is created 
during the edit process and is used to reolace the input 
file after completion of the edit process. The EDIT command 
can be used with any type of device, but the input and 
output devices must be different (either different device 
types or different units of the same type). 

The formats of these commands are: 

TEXT [devo:]ofile 
TECO [dev;:)ifile 
EDIT [devo:]of;ie*[devi:]if;ie 

where. 

devo - output device where the new file is to be stored 
of lie - name of file for output 
devi - input device from which old file is to read 
If tie - name of input file 

After one of these three commands is executed. XTECO is 

In 'edit mode" and issues a double quotation mark ("") as a 
command prompt Instead of an asterisk. 



Hll 

SEQ 0137 
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TKt thirteen coMsnds available !n edit mode are listed by 
type of functiof^ in the following table: 

Edit Hode CoflMsnds 

Pointer Location 

L - Mve the pointer line by line 
C - move the pointer character by character 
J • Mve the pointer to the beg inn! no of text 
ZJ - Mve the pointer to the end of text 

Search 

S •* search for specified string in text now in memory 

N - search for specified string in remainder of text Pile 

flodify/Oi splay Text 
T - type text 
D - delete character (s) 
K . delete lineCs) 
I - insert text 

A - append text to that currently in memory 

Terminating Edit Hode 
EX - ex;t edit mode 

All commands are terminated by two altaoda (•a c ap s ) 

characters. The altmode (escape) key is usually the 
left -uppermost key on DEC terminals. The altmode (escape) 
character is echoed on the terminal as and is 
represented that way in examples in this chapter. 
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Th« folloMino sections explain each edit mode command in 
detail. FolIoMing these explanations, there is a sample 
edit session. 

In examples Nhere it is important to display the position of 
the pointer, a caret, "t", is used to designate the position 
M'thin the sample text. This Is for Illustrative purposes 
only! This char icter is not used for this purpose in actual 
operation. 
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7.2.1 A Cnmm4 

The A co4MM«nd is used to increase the amount of text stored 
"n mei^cry. This is done by reading the next section of text 
from the Input file and "appending^ it to the text already 
tn core. You may append as many sections of text as memory 
s*ze limits alloM. 

^he format of the command is: 

All 

The combined sections of text !n memory are treated as a 
s'ngle section by the previously described commands. 
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7.2.2 C COMWJ 

TK« C coMnand Is used to i>K>ve the pointer on a 
character-by-character basis. Lines are not recognized by 
this coflMiaod; the carriage return/line feed sequence is 
treated as tmo characters. The pointer may be moved forward 
or backward any nunber of characters with'n the text 
currently stored in nemory. 

The format of the coamand is: 

In]CII 

where n is an optional argument that specifies the direction 
to move and the number of characters encompassed by the 
move. It is a decimal number that is positive for forward 
motion and negative for backward motion. If it is not 
specified. "1^ is assumed. 

Following are examples of the C command. The caret, ''t" 
indicates the position of the pointer after execution of 
each command. XTECO' s prompt ("") is also shown in the 
examples. 

Command Text In Memory 

;NEXT COMMAND UILL TtEST RP06 
:ALL ERRORS UILL BE REPORTED 

"C$$ ;NEXT COMMAND UILL TEtST RP06 

;ALL ERRORS UIL BE REPORTED 

"-3C$$ .-NEXT COMMAND UILLt TEST RP06 

;ALL ERRORS UILL BE REPORTED 

'10C$$ ;NEXT COMMAND UILL TEST RP06t 

:ALL ERRORS UILL BE REPORTED 

'3CI$ 5 NEXT COMMAND UILL TEST RP06 

stALL ERRORS UILL BE REPORTED 

Please note the effect of the carriage return/line feed 
sequence on the execution of the last command in the example 
above. The sequence counts as TUO characters. 



Lll 

SEQ 0141 
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7.2.3 0 CoHMid 

The 0 coiMRand is used to delete characters from the text in 
flie»ory. Any nuiiber of characters, either preceeding or 
following the current pointer position, may be deleted. 

The format of the command is: 

[n]OM 

Mhere n IS an optional argument that specifies the number of 
characters to be deleted. It is a decimal number that is 
positive if the characters follow the current pointer 
position and is negative if they preceed it. if it is not 
specified, "1" is assumed. 

following are examples of the 0 command. The caret, "t". 
indicates the position of the pointer. XTECO's prompt ("") 
Is also shown In the examples. 

Command Text in Hemory 

sCOMtMENT LINE IN BATCH CONTROL FILE 

"4D$* jCOMt LINE IN BATCH CONTROL FILE 

'-3D$* :t LINE IN BATCH CONTROL FILE 

"DM ;tLINE IN BATCH CONTROL FILE 



Mil 

SEQ 0142 
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7.2.4 EX Cmmnd 

The EX conmand is used »<hen all editting operations have 
been conpleteo. The output file is closed. If the edit 
session was initiated using the TECO command, the input file 
Is renamed with a .BAK extension and the output file will be 

fiven the original nc e of the input file. XTECO will no 
onger be in edit mode as signified by the switching of the 
prompt character back to an asterisk from a double 

quote ). 

The format of the command Is: 
EXM 



B12 
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SEQ 0144 



7.2.5 Z C^mK 

Th« I nmmmrt^ is us€d to insert ncN text. The text is 
inserted after tH« current pointer position. The pointer 
Mill be positioned after the noM text upon completion of the 
insertion. 

Th« format of th« command is: 
Itexttt 

Mh«r€ "text" Is the text to be Inserted. 

Th« Inserted text can consist of any valid text characters* 
Valid text characters ar^ all printing characters, tab, 
carriage return, line feed and form feed. 

following are examples of the I commanu. The caret, "t". 
Indicates the position of the pointer after execution of 
each command. For purposes of Illustration, line 
terminators are depicted '«n these examoles. The return 
typed by the user Is represented as '•<RET>''". The tNO 
character sequence generated by the return and stored in the 
text 's represented as •*<CR><LF>". XTECO's prompt is 
also shOMn In the examples. 



Command 



Text In Memory 

R UPD2<CR><LF> t 



'IPIP$$ 



R UPD2<CR><LF> 
PIPt 



•I DK0:«DK1:<RET> 



R UPD2<CR><LF> 

PIP DK0:«DK1:<CR><LF> 



t 



CO^IHAND 



TEXT IN MEMORY 



FILE DKl:«DKt:<CR><LF> 



12%% 



FI.E DKl:«DK2t:<CR><LF> 
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7.2.* J Conwt 

J coi«»Ad 'S used to position the pointer at the 
beg nr'ng of all text currently stored in niemory. 

^orwat of the coMand iS: 

Jl$ 

*^he coMand 7 s terfiilnated by tuo altniodes or escapes whid 
are echoed or» the terminal as as shown above. 

^oIIoM^ng Is an evanple o^ th« j co^nmand. The caret, 't" 
'ndlcates the position o^ the pointer before and after 
coMiand execution. 
Initial sta'Le: 

P PPOGl 

R PR0G2 

R PROGtS 

After execution of the J co^wnand: 

♦R PROGl 
R OR0G2 
R PR0G3 
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7.2.7 K tmmmi 

i< coMsnd Is us«d to delete lines of text from the text 
stov'eo in »e4»ory. A line of text !s a string of characters 
between carriage return/line feed sequences. (This sequence 
*» prodLPced by typing the "return" key on your terminal.) 
Oelet'on of a line Includes the deletion of the terminating 
ca^^ age raturn/line feed sequence In addition to the 
c^aracters n the line. Any number of lines may be deleted 
e*th«r preceeding or following the current position of the 
po'nter. If the pointer is positioned within a line, not 
ai: of the I'ne will be deleted (see examples that follow). 

format of the command is: 

[njKII 

wK«ra n *s an optional argument that specifies the number of 
I'nas to be deleted. It is decimal number and Is positive 

the lines preceed the pointer and negative if they follow 
't. If this argument is not specified. '1*' Is assumed. 

following are examples of the K command. The caret. "t'\ 

*vid'catea the position of the pointer after the execution o 

each CO— and, XTECO' s prompt ( ' ) Is also shown in the 
examples. 

CoMiand Text In Memory 

: START OF CONTROL FILE 

tR PROGl 

R PR0G2 

R PR0G3 

R PR0G4 

J END OF FILE 

<$$ : START OF CONTROL FILE 

tR PR0G2 
R PR0G3 
R PR0G4 
;ENO OF FILE 

-IKU tR PR0G2 

R PR0G3 
R PR0G4 
;ENO OF FILE 

2*^$$ tR PR0G4 

;END OF FILE 
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SCH 



R PtP0G4 

;END OF FILE 



-Kit 



P PtjEND OF FILE 



Note the effect of the K coMiend Mben the pointer Is not 
Doe't'o^d et the beginning of a line. You can easily 
oetenilne tHe effect of any K coMand by Issulno a T coNtmand 
«'tH the '^entical format. Whatever Is typed a'ter you 
*ssue the T coMRand Is what Mill be deleted by the K 
coMiand. (The coM^ands 3T and 3K are of identical format.) 
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7.i.9 L CmmM 

Th« L eoMand is uMd to move the pointer on a line-by-linc 
bMis. A line of text !s a string of characters between 
carriage re turn/ line feed sequences. (This sequence is 
produced by typing the 'return" key on your terminal.) The 
pointer can be laoved either backward or forward any nufnber 
of lines in the text currently stored in memory. The 
pointer is always positioned at the beginning of a line 
after execution of the L command. 

The format of the command is: 

[n]L$$ 

where n is an optional argument that specifies the direction 
to move and the number of lines encompassed by the move. It 
is a decimal number that is positive for forward motion and 
negative for backward motion. If It is not specified, "1' 
is assumed. 

following are examples of the L command. In these examples, 
a caret* "t", indicates the position of the pointer after 
execution of each command. XTECO' s prompt ('*) is also shown 
'n the examples. 

Command Text in Memory 

« ZRLAt?? 

If ERROR THEN 

PRINT RLOl HAS HARDUARE PROBLEH 
END 

•Lfl R ZRLA?? 

tIF ERROR THEN 

PRINT RlOl HAS HARDUARE PR06LEN 
END 

•-ILII tR ZRLA?? 

IF ERROR THEN 

PRINT RLOl HAS HARDWARE PROBLEM 
END 

'2L$I R ZRLA?? 

IF ERROR THEN 

tPRINT RlOI has HARDUARE PROBLEM 
END 
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7.2.f N CiMWi 

Th« N coMiand Hm tK« effect of a "non-stop" S coHMAand. It 
is exactly like tb« S coMiand. except that it searches 
through all re«aining text in a file. 

The forfliat of the co«Miand is: 

NstringK 

where -string" is the character sequence to search for, 
Th*s string can consist of any nuniber of valid characters, 
'nclLiding tab, carriage return and line feed. 

The editor searches through text in memory, starting from 
the current pointer position, until either a match is found 
or the end of text is encountered. If the editor falls to 
find a match for the specified string within the text 
currently in memory, it writes the text in memory into the 
output file and brings more text !n from the input file. 
Th;s process continues until either a match is found or the 
ent>e input file has been checked. 

The J command can not be used to recover from a failed 
search If that search caused the section of text that you 
started from to be written to the output file. In this 
case, you must ext edit mode and re-enter with the previous 
output file as *nput. 
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7.2.10 S 

Th« s coMiand c»us€S the editor to scarcH for a specified 
string of Characters in the text currently stored in memory. 
Searches take place in the forward direction only. The 
search encompasses the text in memory only. 

The format of the command is: 

Sstr Ing$$ 

•ihere "string" is the character sequence to search for. 
This string can consist of any number of valid characters* 
'ncluding tab, carriage return and line feed. 

The editor searches through text in memory, starting from 
the current pointer posit lone until either a match is found 
or the end o*" text is encountered. An error message is 
printed if a match is not ^ound. The pointer Is positioned 
AFTER the string found by the search or after all text in 
memory if no match Is made. (You can reposition the do inter 
to the beginning of text In memory after a failed search by 
using the J c o mmand. ) 

Pol lowing are exMples of the S command. The caret. *'t". 
Indicates the post ion of the pointer after execution of each 
coiMiand. XTECO' s prompt ("") Is also shown in the 
examples. 

Command Text in flemory 



tR UPDAT 

PIP DX0:'DX2:*.BIN 
EXIT 



''SDXIM 



fl UPDAT 
PIP DXO:« 
EXITt 



0X2: •.BIN 



"Jll 



"S0X2I$ 



tR UPOAT 

PIP 0XO:«0X2:*.BIN 
EXIT 

R UPOAT 

PIP 0X0:-0X2t:».BIN 
EXIT 



In the above example, the first search failed, 
would print an error message: 



The editor 



H12 

SEQ 0150 



112 
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NOT rOUNO: 0X1 
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7.2.11 T Cmmmna 

Th« T coMRSAd is us€d to typc text on the console terminal. 
The text typed s relative to the position of the pointer in 
the text currently stored in memory. Typing is line-by-line 
and any number of lines before or after the current pointer 
position may be typed. A line of text is a string of 
characters between carriage return/line feed sequences. 
(This sequence is produced by typing the "return" key on 
your terminal.) If the pointer is positioned Mtthin a line 
of text, typing starts/concludes at the pointer position 
(s«e examples)* 

The format of the coMiand is: 

(n]T$$ 

where n is an optional argument that specifies the number of 
lines to be typed. It is a decimal number that is positive 
If the lines folloM the pointer and negative !f the preceed 
It. If n is not specified, "1" is assumed. 

HT is a special form of the T coiMiand that causes all text 
currently stored in memory to be typed, regardless of the 
position of the pointer. 

FolloMino are examples of the T conimand. The caret, "t". in 
the sample text Indicates the position of the pointer. 
XTECO's pro«ipt ("") is also shown in the examples. 
First sample text: 

; BATCH CONTROL FILE FOR TESTING THE DZll 
tR ZDZA?? 
R ZDZB?? 

;ENO OF OZll TESTING 
Co4MRand Text Typed 

'T$$ R ZDZA?? 

"-1T$$ ;BATCH CONTROL f-ILE FOR TESTING THE DZll 
'2T$$ R ZDZA?? 

R ZDZB?? 

Second sample text: 

R PROGl 
R PR0tG2 
R PR0G3 
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CoiMitand T«xt Typed 

Ut G2 
' -If II R PROGl 

R PRO 

'OTII R PRO 

HTII R PROGl 

R PR0G2 
R PR0G3 



K12 
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SEQ 0153 
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7.2.12 ZJ Ctmmi 

Th« ZJ coflMiand is used to position the pointer after all 
text currently In ncMory. 

The foraat of the cotwnand is: 

ZJII 

FollOMing is an cxwnplc of the ZJ command. The caret, "t", 
indicates the position of the pointer before and after 
coMiand execution. 
Initial state: 

tR PROGl 

R PR062 

R PROGS 

After execution of the ZJ command: 

R PROGl 
R PR0G2 
R PR063 
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2 I CoiMiand The I coMand is used to insert new text. The 
text is inserted after the current pointer position. The 
pointer will be positioned after the new text upon 
coiipletion of the insertion. 

The format of the coMiand is: 



where "text" is the text to be inserted. This text can 
consist of any valid text characters. Valid text characters 
are all printing characters, tab, carriage return, line feed 
and for* feed. 

Following are exaiiples of the I command. The caret, "t". 
indicates the position of the pointer after execution of 
each coMand. For purposes of illustration, line 
terminators are depicted in these examples. The return 
typed by the user is represented as "<RET>'"'. The two 
cnaracter sequence generated by the return and stored in the 
text ^s represented as "<CR><LF>". XTECO's proi^t ("") is 
also shown in the examples. 



Itext$$ 



Command 



Text in Memory 
R UPDAT<CR><LF> t 



'IPIP$$ 



R UPDAT<CR><LF> 
PIPt 



'I DK0:*DK1:<RET> 
$$ 



R UPDAT<CR><LF> 

PIP 0K0:»DK1:<CR><LF> 



t 



COMMAND 



, TEXT IN MEMORY 



FILE DKl:»DKt:<CR><LF> 



FILE DKl:«DK2t:<CR><LF> 
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7.3 CoAinio9 Edit Co— 

The user con combine several edit mode commands on a single 
command line. This !s done by separating each command by a 
single escape (altmode) character and then terminating the 
entire string of commands by two escapes. For example, the 
following commands: 



:ntest$$ 

:0T*$ 

can be combined into a single string: 



I'NTESTIOTITM 

In both cases. XTECO will do a non-stop search for the 
string "TEST", type the characters from the beginning of the 
line where the string was found to the current pointer 
position and then type the characters from the current 
pointer position to the end of the line. Combining commands 
*s merely a convenience for the user. It is suggested that 
you do not attempt to combine commands until you are 
familiar with the operation of individual commands. The 
next section has sample edit sessions that show both 
methods. 



7.4 SMple Edit SMSions 

Uhat follows is a series of sample edit sessions that show 
you the various ways of handling XTECO. In these examples, 
the underlined text Is that which Is typed by XTECO. At 
appropriate locations, comments have been Included for 
reader assistance. These comments are enclosed in square 
brackets ([]) and should not be confused with the actual 
dialogue that is taking place between user and software. 
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7.4.1 Stflpl« m^h&i for Gr«»tino • T«"t Fil« 

.8 XTECO 

TEXT TEST.CCC 

IUs«r cresting n«M fil« on 

syst««i device called TEST.CCC] 

lIjTHlS IS A BATCH CONTROL JOB FOR TESTING THE RXOl 
{THIS IS A FICTIONAL JOB FOR OEnO OF XTECO ONLY! 
s 

R ZRXX?? 
RES/PAS: 1 
N 

EXIT 

{THE FIRST RXOl DIAGNOSTIC HAS BEEN RUN. 
I 

R ZRXY?? 

«ES/PAS:l/TES:l-5 
N 

EXIT 

{END OF RXOl TEST 
tt 

:Exif 
ex:* 



B13 

SEQ 0157 
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7.4.2 Oi«i«i«it an Em'sting T«iit Fil« 

XTECO 

TECO TEST.CCC 

[■'H* user Is going to change TEST.CCC. 
o» th« system device.] 

:SRX02$$ 

2 vol 50yW; exo£ 
:T$i 

iiHis IS A 6AICH cmiBOL JOB £08 lEsiivG M em 
:2TM 

ilHXS IS fi EICIIOML JOB £06 DChO OE 2IEC0 QHLtl 

:exii 

CXIT 
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7.4.3 UM of C«*;«wd £4i\ Ztmm^ 

.fl XTECO 

PIT Ol1:TEST1,CCC-TEST.CCC 

:eo:' test.ccc. which is on the system 
device. and place the eoitteo output 
into a file called testl.ccc on dll.] 

.npas:»ott$$ [search for 'pas:" and type line] 

9eS/?AS;I 

.DI2$0TT$$ [DELETE NEXT CHAR AND INSERT "2"] 

9es/eASi2 

:ex$$ 

EXIT 



^^«rc arc three XTECO commsftds that arc not related to 
actual text file editt'ng. These coMiands are provided for 
jMr convenienca. 



7.S.1 TYPE mi MXNT 

^he T<PE and PRINT coMnands are used to print text files on 
the console tertiinal and line printer respectively. They 
are eoulvalent to the JPOAT coomands of the saute naote. 



E13 
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7.5.2 POT 

£XIT coMMand $ used to return control to the XXOP 
•on'ter. 



CHAPTER 8 
BATCH CONTROL 



itO^ hM • facility for running proorMs without operator 
'nttrvent *on. This fsciltty Is cslltd batch co«^trol or 
chtt 'n'ng. Th« coMands that MOuld normsllv b« Issued by an 
operator arc put Into a text file (usln^ XiECO ) and the 
monitor procassas th« co«Miands In this fila rathfr than 
raou'r'ng an operator to antcr each coMand nanually. 



t.l OMcripti«i 

Once a batch control file has been created. It can be used 
over and over again. Th« batch control process releases you 
fro« having to do repetitive tasks such as building new 
•edia or running a cowwon set of diagnostics. Hore 
*fliportantly. batch control lets you develop a test strategy 
and use th« strategy consistently. This is done by 
selecting the proper diagnostics and running thaw m a 
particular order and «ode to achieve the best test process. 
3nce the process Is developed. It Is put into a batch 
control file. 

Cider versions of XXDP had very limited batch control 
services. Essentially you could chain' together a series 
of run coamands which would run various diagnostic programs, 
such as: 

P PROGl 
P PR0G2 
P PP0G3 

*ou could 'ntermix comments to be printed as the chain was 
processed. This prim't've process was adequate for most 
s'mpla procedures, but was not adequate for more 
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sophist I cattd operations such as update kits. 



t.l.l IMi Cantr^ Functiena 

XXOP now contains a fairly sophisticated set of batch 
control functions listed below. These functions and 
techniques for using the« to run diagnostics and utilities 
are described here. 

Batch Control Functions 

Monitor Co«Miands iionitor commands: L. S, C. and E) 
UtU'ty Co«Miands UPDAT. SETUP, etc. 

OAS Co«Mands all DPS cotMands and diagnostic dialogue 



8.1.1.1 Nviitor Co— an<a 

Certain of the nonltor coMands described In Chapter 2 can 
be used In a batch control file, ^^hey are the L, S, C 
and E coMands. There are two functions which are different 
when used tjr>6tr batch control instead of Operator control. 
F*rst« the R (Run) CoMinand has a pass switch for usa with 
diagnostic prograiis which are not DRS conpatible. The 
diagnostic mmy be run a certain number of passes by using 
the switch as shown: 

R OIAG/5 

OIAG w'll run 5 passes before the batch operation continues 
on. 

The C (Chain CoMiand) aay be used In a batch file with one 
restriction. Batch operations can be nested one level only. 
That Is. a batch file may start another batch file and then 
continue after the second file has been processed* but the 
second batch file may not start another (third) file. 

U'th these exceptions, the monitor commands function under 
batch control as they would under operator control. 
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• .1.1.2 Utility C0Miw» 

Th« coMMands for various XXDP utilities may be used in batch 
control operations. 



8.1. l.S ORS Cuwmmm 

All of the ORS co«Miands described in Chapter 3, includina 
all SM itches and flags, can be used in a batch control file. 
All dialogue that would normally take place between an 
operator and a ORS diagnostic can also be placed in a batch 
control file. Batch Commands 



0.1.1.4 Bmtch Control 

The following batch control commands can be used: 



conditionals 

GOTO tag 

PRINT 

auiET 

QUIT 
SMI/CMI 

WAIT 



sections of the batch file can be 
processed conditionally under operator 
control or runtime conditions 

begin processing at another section of the 
batch file designated by "tag" 

temporary override of QUIET 

inhibit printing of batch file if printing 
or enable printing if printing was 
inhibited previously 

terminate the batch operation 

enable/disable manual intervention 
operations in specialized diagnostics 

stop batch operation until the operator 
types a Control X 



8.2 Bmtch Control Co— nda 



HI 3 

SEQ 0163 
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8.2.1 CM4iti0Vi«l« 

Sections of a batch control file can be processed, or not 
processed, based on either operator input or certain 
conditions. There are three conditional statements. 

1. IF condition THEN 
statementCs) 

END 

2. IFERR THEN 
state«ent(s) 

END 

3. IFLMO n THEN 
stateaentCs) 
END 

If the condition specified Is true, the statennents between 
the THEN and END statements will be processed. If the 
condition Is false, these statements will be ignored. 

The conditions used In the first type of statement are ASCII 
character strings which are defined by the person writing 
the batch file and used as switches by the operator. For 
example* suppose a person is writing a batch file for 
running IPDAT and doing some file operations. If a part of 
the process requires the presence of an RX02 on the system, 
there would be a need for the operator using the batch file 
to be able to specify whether or not there was an RX02 
present. The batch file writer would define a conditional 
section of the file as shown below. 

IF RX02 THEN 
statement(s) 
END 

The condition "RX02" Is now used by the operator as a switch 
to the Chain command: 

C FILE/RX02 

The monitor stores the string of characters for comparison 
With the conditions In the batch file. There Is only one 
pre-defined switch and the writer Is free to create anv 
other he or she desires. The pre*deflned switch Is "/QV 
(quick ver'fyj which causes diagnostics to be run one pass 
only. Any number of switches may be used In a command. 



113 

SCO 0164 
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The second type of conditional statement can be used with 
OAS-type diagnostics only. If a test error Nas detected by 
tKe last OAS -type diagnostic that Mas run in the batch 
file. the stateiients will be processed. 

The third type of conditional uses the media- type byte in 
physical location 41. If the type code matches the one 
specified in the conditional ("n")» the statements will be 
processed. 



•.2.2 60T0 

The GOTO statement is used to transfer control within a 
batch control file. Uhen the monitor encounters a GOTO 
statement, it searches for the specified tag and resumes the 
batch process at the statement following the tag. A tag is 
an alphanumeric strino terminated by a colon (":"). The tag 
may occur before or after the GOTO statement in the batch 
file. The following are examples of the GOTO statement: 

TAGl: 
R PROGl 
GOTO TAGl 



GOTO TAG2 



TAG2i 
R PROGS 

In the first example, the batch process will loop backwards 
jnt'l Interrupted by the operator. In the second example, 
control will be transferred forward to TAG2. Any statements 
between the GOTO statement and the tag are ignored. 



8.2.S PUNT 

The PRINT statement is used to force the tvping of a line of 
text while typing Is Inhibited by the QUIET statement. 

^he format of the statement Is: 



J13 



SEQ 0165 



XXOP UMr's Gui^ — Batch Control 



Page 8-6 



PRINT text 

Th« text on the aamc line aa the PRINT will be typed. 



•.2.4 amcT 

The QUIET atateaient la used to control typing of the batch 
file. The atateaient ia used like a '"'flip-flop". The first 
tlfl»e the atatetient Is encountered, all typing ia suppressed 
(with the exception of error messagea). The next time it is 
encountered, typing is reenabled. The third time it is 
encountered, typing is inhibited again and so on. 



0.2.5 OUZT 

The batch job is immediately stopped when a QUIT statement 
's encountered. The monitor returns to normal operator 
mode . 



•.2.6 SHI/CHI 

The Sni and CHI statements are used to enable and disable 
manual intervention modes In ORS-type diaonostics. Normally 
all testing that requires manual Intervention by an operator 
are Inhibited during batch control operations. These 
statements allow this to be over-ridden. Obviously caution 
's suggested when using this feature. 

SHI - set (allow) manual Intervention 

CHI - clear (don't allow) manual intervention 

CHI is the default state when a batch Job is started. 



•.2.7 IMH 

Uhen a UAIT statement Is encountered, the monitor stops 
processing the batch file and waits for the operator to type 
a CTRL-X (typed by depreasing the CTRL and X keys together), 
''his 's typically used in conjunction with manual 
intervention feature as shown In the example below. 
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PRINT THE NEXT DIAGNOSTIC REQUIRES THAT A 
PRINT SCRATCH MEOI' 1 BE MOUNIEO IN THE RLOl/02. 
PRINT TYPE tx UHEN READY 
WAIT 

R ZRLA?? 



B.S Co—anta 

CoflM«nts can 6a Included in the batch file. CoiMients are 
typed as the file !s processed unless QUIET mode is invoiced. 
A coni^ent IS a string of text that starts with a semicolon. 

;THE NEXT PROGRAM TESTS THE DZll 

R ZDZB?? sRUN THE DIAGNOSTIC 



8.4 Batch Cantrol of Diagnoatica 

For -the purposes of batch control, there are ti*o types of 
d' agnostics: chalnable non-DRS-type diagnostics and 
DRS-type diagnostics. The first type can be batched by a 
simple run command: 

R OIAG[/n] 

where n is an optional argument that specifies the number of 
passes that the diagnostic will run. The default is one 
pass. 

ORS-type diagnostics require complete batch control. All 
commands normally entered by an operator must be in the 
batch file. For example: 

R 0IAG2 
START/PASS:! 

Y [answer for CHANGE HU] 

1 [answer for number of units] 

[insert answers for all HU questions] 
EXIT [to return control to batch job] 

This is Just a short example. The concept to note is that 
the batch file Is an INDIRECT COMMAND file for DRS. All 
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coMianda that are required when running under operator 
control are necessary in the file. If the diagnostic 
program In the above example had used a software table* it 
Mould have been necessary to provide the commands required 
to support it. 

The user does not ^ave to enter all commands via the batch 
file however, usin9 the SETUP utility (Chapter 6), all 
hardware and so' .ware information could be supplied to the 
diagnostic prtcr- to running the batch job. This is the 
recoiMiended method for using ORS-type diagnostics in the 
batch control en iv^onment* If you preset all the 
parameters, the following commands are all that are 
necessary : 

R 0IAG2 

START/PASS:n 

N 

N 

EXIT 

where n is the number of passes to execute. 



6.4.1 OiMiQ^tic 



A DRS diagnostic in a chain file can be aborted by and tC or 
a tZ. If you abort with a tC, the chain file can test for 
the tC and alter the flow of control. For example : 

R OIAG 

N 

N 

EXIT 

IF .tC THEN 
GOTO LI 
END 

If you abort with a tZ. the chain file cannot test for it 
and the flow of control cannot be changed. 



6.4.2 Batch Control of Utilitioo 

Most of the XXDP utilities can be used under batch control. 
The utilities thet are batch controlable are: UPDAT. SETUP, 
and PATCH. To run a utility under batch control, simply 



M13 

SEQ 0168 



XXOP User's Guid« Batch Control 



Page 8-9 



create a batch file that contains all of the comma<tds that 
are normally entered by an operator. For example, to build 
an RXOl floppy diskette for XXOP using UPOAT under batch 
control : 

R UPOAT 

LOAO HMOX??.SYS 
SAVn 0X0: 
CREATE OYO: 
FILE 0YO:-0RSXM,SYS 
FILE 0YO:-0IR.SYS 
FILE OYO:»OY.SYS 
EXIT 

Note that the dialogue Hith UPOAT must end Hith an EXIT 
coamand in order to finish the batch Job or to allOH further 
batch furctions. 



V 
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APPENDIX A 
GLOSSARY 



'^hls Is a glossary of cownon terms usad in connection with XXOP. 

autodelete - a possible effect of the file transfer process 
wKereby a file from the Input medium replaces a file of the 
same name on the output medium. In UPDAT, only transfers 
'nitlated by a FILE command can result In autodelet Ion« 

boot block - the first physical block an a medium (block zero). 
This block contains the XXDP Secondary bootstrap for the 
device. 

bootstrap - very simple code used to load and start more complex 
code from a medium such as a disk. The term comes from the 
phrmse "Picking oneself up b/ the bootstraps'*. See also 
'primary bootstrap" and "secondary bootstrap". 

bjf^er - a section of memory reserved for storing data, usually 
fro* a file, as opposed to executable code 

console terminal * the video or hardcopy terminal attached to the 
system via the Dl Interface at bus address 177560. 

de>/'ce driver - that software which has the function of 
controlling the operation of a specific hardware component 
> a systesi. An RX02 driver, for example. Is that software 
that accomplishes such tasks as selecting a phvslcal block, 
reading a block of Information, etc. on an RX02 disk . 

0e./'ce handler - see 'device driver" 

ojmp t^ process whereby an Image of the contents of memory Is 
placed on a storage medium. 

eo't to mod'fy te«t 'nformat'on In a file 
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ed'tor - a utility program used to modify text files 

Hardware table - data structure where ORS stores the information 
regarding units being tested 

load ' the process lihereby the contents of a file containing a 
program image are placed in memory. 

medium - physical storage such as a disk or magtape. In this 
manual, the term "medium" Is equivalent to ^XXuP medium". 

pass - a unit of diagnostic operation. A ORS-type diagnostic 
pass Is defined to be execution of all specified tests on 
all active units. 

patch - a temporary remedy for a problem in a program that is 
accomplished by altering the program image stored on the 
XXDP medium. 

physical block - a group of data consisting of 256 (decimal) 
Mords. This IS the standard size of data transmission to 
and from the XXDP media. 

physical location - an ^solute memory reference (see "virtual 
location-). 

pr'mary bootstrap - code, usually stored in a ROfI, which loads 
the "boot block" (block 0} from a medium into the first 256 
(decimal) words of memory and then transfers control to 
memory location 0. 

program buffer * a section of memory used by UPOAT for loading 
program Images. 

secondary bootstrap * code that resides In the boot block (block 
0) of a medium. This code Is loaded and started by the 
primary bootstrap and 'n turn loads an starts tiie XXDP 
monitor. 

software table - data structure where ORS stores Information 
regarding operational characteristics of a diagnostic 

sw'tch - a modifier for a command 

system med'um - the medium on the device from which the XXDP 
System was booted 

text a collection of ASCII formatted data consisting of 



prlnt*^ cHar»ct«rs, tabs, carriage returns and form feeds. 

V >tual location - a relative iie' reference. A program image 
t^at has been loaded int ; program buffer by UPDAT uses 
v>tual locations; that program location 0 Is not 

physical memory location C, n is the first physical memory 
location In the program buffer. The XXDP monitor does 
absolute loads and In this case program location 0 Is not 
v'rtual. but *s actually memory location 0. 

> med'um - phys'cal storage, such as a disk pack. MAGtape. 
cassette, etc.. that has been formatted for XXDP use. 
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's •poc'^div SUMRsrIzcs th« follOMing: 
Monitor CoMiands 

OAS CoMiands. Switches, and Flags 

UPOAT CoMiantfs 

PATCH CoiMands 

XTECO CoMtands 

Batch Control Pjnct'ons 
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• .1 Nviitor 



C run • batch Job (chain) 

0 list directory of load wicdium 

E cnablt alternate system device 

P set the terminal fill count 

N type help information 

L load a program 

R run a program 

S start a program 

TEST run batch f'le: SYSTEM. CCC 



•.1.2 » Nanitor 



Boot Boot a device 

Chain run a batch job (chain) 

COpy Copy a file or device 

DAte Set the date or report the date 

DElete Delete a file 

Directory list directory of load medium 

Enable enable alternative drive for system device 

Help type help information 

Initialize Initialize a device 

Load load a prooram 

Print Print a file on the system line printer 

PEname Rename a file to a new name 

Pun run a program 

SEt Set dev'ce or system parameter 

Start start a program 

"^ype Type a file 
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1.2 ORS tumumm 



ADD activate a unit for test! no 

CO^TI^MJe continue diagnostic at test that Mas 

interrupted bv a tC 

DISPLAY print a list or device information 

WOP deactivate a unit 

EXIT return to XXOP runtiM monitor 

^LAGS print Status of all flags 

PRINT print statistical information 

Pt^OCEED continue from an error halt 

RESTART start diagnostic and do not initialize 

START start the diagnostic and initialize 

Z^LAGS react all flags 



t.S ORS CoMsw< SMitchM 

/EOP:ddddd report end-of-pass after each ddddd passes 

(ddddd ' 1 to 64000) 
/FLAGS: flag- list set specified flags 

/PASS: ddddd execute ddddd passes (ddddd - 1 to 64000) 

/TESTS: test- list execute only the tests specified 
/UNITS:unit-i;st command Nil! affect only specified units 



■.4 ORS flmm 

Flag Effect 



ADR execute autodrop code 

BOE "bell" on error 

E VL execute evaluat i on 

HOE halt on error 

IBE inhibit all error reports except first level 

IDR inhibit program droppino of units 

lER Inhibit all error reports 

ISR ir'iibit statistical reports 

IXE Inhibit ex^.nded error reports 

LOE loop on erf 

lOT loop on test 

PNT print test numbrr as test executes 

PRI direct messages to line printer 

^Af unattended mode (no manual intervention) 



Co«Mii«nd Summary 



8.5 UPMT Co— 



ASG assign a logical name to a dcv'cc 

BOOT bootstrao a ^vice 

CLW clear \JPD2 program buffer 

COPV copy entire meaium 

DEL delete a f'le or files 

OIA give directory of specified medium 

00 execute an indirect command file 

Dt^IVER load a device driver 

OUhP dump a program image 

EOT write logical end-of-tape mark on a tap« 

EXIT return control to the runtime monitor 

FILE transfer a file or files 

HI COPE set upper memory limit for dump 

LOAD load a program 

LOCOPE set loner memory limit for dump 

HQO modify file image in memo"'y 

PIP transfer a file or files 

WJINT print a file on the line printer 

READ read a file to check validity 

REN rename a file 

SAVH save a monitor or^ a disk 

SAVE save a monitor on a tape 

TrPE type a file on the cor^sole terminal 

X^R set transfer address 

ZERO initialize a medium 
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t.6 PATCN Co—w<i 



60CT Boot specified device 

CLEAR Clear input table 

EXIT Return to XXDP monitor 

'^ETM Load DEC/Xn MAP file 

bETP Load saved input table 

KILL Delete address from input table 

MOO Enter address in input table 

PATCH Crreate patched file 

SAVP Save input table 

TYPE Print Input table on terminal 
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•.7 XTECO Co— mJi 
••7.1 Nofi-«dit tnmmm4B 



EDIT - modify • fiU 

EXIT - return to won i tor 

PRINT - print • fil« on th« lint printer 

TEXT - create new text file 

TECO - iiodify e file on disk 

TfPE - type e file on the console terminal 



1.7.2 E4it CiMiw<i 



A - append text to that currently in meniory 
C - Mve the pointer character bv character 

0 - delete characterCs) 
EX - exit edit mode 

1 - insert text 

J - fiove the pointer to the beginning of text 

K . dtlete lineCs) 

L - fiove the pointer line i>v line 

N - search for specified string in remainder of text file 
S - search for specified string in text noM In memory 
T - type text 

2o - move the pointer to the end of text 
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B.S totch Control Functiono 
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Monitor CoM^andS 
Utility CoMiando 
ORS CoMonds 
conditionals 

GOTO tag 
QUIET 

PRINT 
SMI/CMI 

QUIT 
UAIT 



monitor cociinands: L, S, Ct and E) 
UPDAT, SETUP, otc. 

all DRS commands and diagnostic dialogue 

sections of the batch file can be 
processed conditionally under operator 
control or runtime conditions (e.g. IF, THEN) 

begin processing at another section of the 
batch file designated by "tag" 

inhibit printing of batch file if printing 
or enable pr ! nt i ng if pr i nt i ng was 
inhibited previously 

temporary override of QUIET 

enable/disable manual intervention 
operations in specialized diagnostics 

terminate the batch operation 

stop batch operation until the operator 
types a Control X 
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APPENDIX C 
DEVICES SUPPORTED 



XXDP supports most mass storage devices. The following 
table lists all devices supported, the mnemonic used to 
specify the device and the name of driver the file. 



0«vic« 




on 1 c Or i v«r 


OISTRIBUTION 


RP04/S/6 


ob" 


...... 




TU58 


00 


00 


TU58 


RLOl/2 


OL 


OL 


RLOl / RL02 


RK06/7 


on 


on 


RK06 / RK07 


Rn02/3 


OR 


OR 




RX02 


OY 


OY 


RX02 


PRINTER 


LP 


LP 




TM02 


nn 


m 


800 BPI HT 


TS04 


ns 


HS 


1600 BPI nr 


U0A50 


ou 


OU 




RO/RX 


ou 


OU 





All drivers assume that the CSR address for the device is 
the standard address as given in the Peripheral Handbook. 
If you have a system with a device at a non*standard 
address, you can modify location 12 in the driver using 
UPDAT. 

XXDP device drivers are. by necessity, small and limited in 
function. They can detect and report three types of errors: 
read, write and hard. These errors are reported and control 
Is returned to the utility being used. The utility then 
takes any further action required. Since the functionality 
of the drivers is limited, the user is required to run 
diagnostics on the device in question if an error persists. 
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APPENDIX 0 
COHPONENT NAMES 



All tH€ co«ipon«nt file nMes begin Mith the letter H. The 
second letter In the nene determines the coinponent type, as 
follOMS: 

M monitors 
U utility programs 
D device drivers 
S runtime services 
Q manuals 

The third and fourth letters indicate the component name and 
the last two letters are the version numbers. 

The utility proorams are distributed under their common 
nam^s. like UPQaT and XTECO, for user convenience and have 
.BIN (or .BIO extensions. 



CoMponent Names 
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Oesciption 



File Name Release Name 



MONITOR files 



XXOP V2 RESIDENT MONITOR 
XXOP V2 EXTENDED MONITOR 
XXDP V2 DATE UTILITY 
XXOP V2 DIRECTORY UTILITY 
XXDP V2 HELP FILE 



DRIVER fil«« 



RP04.5.6 

TU56 

RLOl/2 

RK06/7 

RM02/3 

MSCP 

RX02 

PRINTER 

TM02 

TS04/TS11 



DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 
DRIVER 



BOOT 
BOOT 
BOOT 
BOOT 
BOOT 
BOOT 
BOOT 

BOOT 
BOOT 



UTILITY files 



XXDP V2 OECXll CONFIGURATOR 

AND LINKER 
XXDP V2 UPDATE UTILITY 
XXDP V2 PATCH UTILITY 
XXDP V2 SETUP UTILITY 
XXOP V2 XTECO UTILI'^Y 



UFO files 



XXDP V2 UFD MENU UTILITY 



XXDP DIAG SUPR SML 
XXDP DIAG SUPR EXT 



DocuMcnts 



XXDP FILE STRUCT DOC 
XXDP V2 FILE STRUCT DOC 
XXDP DRIVER PROGR GUIDE 



XXDPSM.SYS 
XXDPXM.SYS 
DATE. SYS 
DIR. SYS 
HELP. TXT 



DB.SYS 
DD.SYS 
DL.SYS 
DM. SYS 
DR. SYS 
DU.SYS 
DY.SYS 
LP. SYS 
MM. SYS 
MS. SYS 



HMSM77.SYS 
HMXM77.SYS 
HUDA77.SYS 
HUDI77,SYS 
HQLP??.TyT 



HDDB77.SYS 
HDDD77.SYS 
HDDL77.SYS 
HDDM77.SYS 
HDDR77.SYS 
HDDU77.SYS 
HDDY77.SYS 
HDLP77.SYS 
HDMM77.SYS 
HDMS77.SYS 



DXCL.BIC HUXC77.BIC 



UPDAT.BIC 
PATCH. BIC 
SETUP. BIC 
XTECO. BIC 



HUP277.BIC 
HUPA77.BIC 
HUSU77.BIC 
HUTECO.BIC 



MENU70.8IC HUtCBO.SYS 



ORSSM.SYS 
DRSXM.SYS 



N/A 
N/A 
N/A 



HSAA77.SYS 
HSAX77.SYS 



CHQFSB0.DOC 
CHQ7770.00C 
CHQ7777.00C 
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APPENDIX E 
BUILDING XXDP 



E.l fiBnitw antf ftaquir^d Fil— 

'^h« alnlMuM files that must be put on a bootable XXDP medium 
are the ao^itor for that mediun. the device driver for that 
•ledium. the OAS (file nana: DRSS.SYS or DftSX.SYS) and the 
directory utility (file noMe: DIR. SYS). The monitor file 
(file nanc: ) must be loaded by UPDAT and then saved on the 
medium using either the CREATE command. These commands are 
described In Chapter 4. 

The remaining files may be put onto the medium using any 
JPDA" file transfer commands. 

ExoiVles (RX02 and TS04); 



.R UPOA-r 
CREATE Dt-O: 
FI..E Dt'0:»Dt'.SyS 
fl^E DyO:-DIR.St'S 
fl^E D''0:«ORSXM.SYS 



0 jP3A' 
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euidng XXDP 
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CREATE HSO: 
PIP «SO:«HS.S>S 
MP MSO:-OI«.SYS 
PZP HSOc'WSXW.SVS 
EXIT 

Th« process tftscr;bcd above places the niNinUH XXDP system 
Of« a «edIuM. Vou can add as many other system components 
(drivers and utilities) as you wish. Don't forget to modify 
location 370 In the XXDPXH monitor If you are using a system 
that Is on 50Hz poMSr. (Location 370 must contain a zero 
value for 60Hz end a non-zero value for 50Hz.) 



t.i UMito Kite 

^he fie XXBLO.CCC Is a batch control file that 
JDdates/buUds XXDP media automatically. To start the file, 
use the chain command. The file accepts switches that 
soec'^y the media type to build and the mode in which to 
bu'Id. All supported XXDP media may be built. The media 
be'ng buUt are always assummed to be mounted In drive 
Cun't) 0 of the dev'ce and that the drive Is ready and 
wr'te- enabled. 

''he ^'ormat of the command I'ne for starting the build 
process s: 

C XXB.D/dev'ce:/mode] 

oew'ce - the mnemonic ^or the devce to be bu' It/updated. 

Supported oev'ces ano the> mnemonics are Tsted 
'n append' C. no device "s spec'f ed, a short 

help message w'll be prnted. 

mode - manne*- 'n wh'ch to bj' lo/ update. Ava'lable mooes 

are: 

DAIWEP a bootable med'um w'th all XXDP drivers 

HONITQP a bootable med'jm w'th all XXDP monitors 

.^1^1"' a bootable med'um w'th all XXDP utlTtles 

S'S'E^ a comp'nato^ o^ the above three modes 

I' r*o mooe 's spec'^*eo. a oootable med'j* Is bu'lt. A 
Doctaole meo'jw co^s'sts a oootable mor'tor mage, the 



Bu:id'n9 YXDP 
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f'ur^tliiit •«rviC€», tK« directory utility, the driver for the 

•led^uii and UPOAT. 

Except tHe cese of sequential devices (e.g.; magtape )• 
the m^6'i\m is not chanMd except for the 

replacettent/addit ion of the new XXOP components specified by 
the mode switch. You may want to back up files that are 
critical however. Sequential media are destroyed. A 
warn'ng message is produced and you are given the 
opportunity to abort the process. 

'To obta'n help wh'le runn'ng the update batch job. use the 
following command: 

C XXBLD^HELP 



APPENDIX ^ 
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F.l MS IMm tuiMiafl 

To save t M an^ energy, pre«>u>ld tH« h«r^arc and software 
tables In a diagnostic using th« SETUP utility. Customize 
the files for a specific svste« on tha XXOP «ealun for that 
syste« or customize files t'or several systef»s on »tdiuA 
snared between systems. Peweinber, vou can always change the 
tables on the fly by using th« START cOMsnd or peroianently 
change th« files by using SETUP. 

Another way to Make XXDP work for you Is to use the batch 
control functions described In Chapter 8 of this Manual, 
raaitllarlze yourself with the DPS-type diagnostics for a 
particular device and Identify th« various operating nodes 
(as defined by th« software tables) that ara nost useful for 
you. Prtbu'il^ the hardware tables for the syste*, or 
systems, you are working with. Then write a batch control 
f le that laplewents the various iROdes based on 
conditionals. This allows you to enter one co«MRand to XXOP 
and then let the system do the rest. 

A slnple example of this type of batch control file is 
follows. For the purposes of this evanple. we will use a 
f'ctlonal diagnostic called 'DIAGl". The normal operator 
o'alogue with this diagnost'c (w'th hardware tables already 

bultTls: 



he batch f tie that has been created for th s diagnostic is 
called 'OlSt^.CCC and 's I'sted below. 




P DIAGl 



''0$ 
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If QV THCN 

R 0IA61 

STA/PAS:1 

N 

Y 

H 

END 

IF REPAIR THEN 
R 0IA61 
STA/FLA:LO£ 
N 

> 
N 

END 

"^^'9 f 1« d«fio«$ two t«$t tnodcs: quick verify and r«pair. 
Mote hoM tKe batch file manipulates the software questions 
•nq also avoids answer ing the hardware questions since the 
tables were already created. The user invokes either of the 
two Modes with one of the following coowiand 

C OISK/QV 

or. 



C DISK/REPAIR 
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APPENDIX G 
ERROR MESSAGES 



error «iessa9cs that could occur during an operation arc 
listed alphabetically below. The lower case letters "device 
error' refer to a series of specific errors that can be 
detected by the device drivers. The possible errors are 
lasted after the error iiessages. 

? ADDRESS NOT FOUND (PATCH) 

The specified address does not exist as an entry in 
the input table. 

? BAD AODR (Monitor) 

An Invalid address was specified with a run or start 
co^^and. 

? CHECKSUM ERROR (Monitor. UPDAT. PATCH) 

Each block In a binary file has a checksun stored !n 
It. If the checksun calculated while reading the 
block does not Mtch the checksum in the block, this 
error is printed. Try the operation again, but the 
file was probably corrupted. 

? COMMAND NEEDS ARGUMENT (PATCH) 

The coMand typed by the operator requires an 
argument, but none was given. 

? DELETE OLD FILE (PATCH) 

The specified output filename already exists. 

? DEVICE BOOT BLOCK NOT INITIALIZED (Monitor) 

An attempt to boot a device that does not contain an 
'nt' all zed boot block will be reported as shown and 
the device w'll not be booted. 

Oev'ce error (Monitor. UPDAT) 



Error H^sSSgeS 
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EacH r€ad/Mr;t€ dtvict drivtr may detect an error 
during an operation. The driver reports the type of 
error and returns control to the program being used. 
This program appends any additional information as 
shoMn in the device error messages. The errors that 
can be reported by drivers are: READ ERROR and 
URITE ERROR. 

? dev'ce error DIRECTORY (PATCH) 

The specified device error occured during the 
operation indicated. Possible device errors are: 
RtAD ERROR (error occurred Mhile reading a block of 
data). MRITE ERROR (error occurred Mhile writing a 
block of data) and HARD ERROR (error occured during 
a non- transfer operation). 

? device error ON INPUT DEVICE (Monitor. UPDAT. PATCH) 
The specified error occurred on the input device 
specified In the last operator command. If the 
error persists, the media or the hardware may be 
bad. Try running diagnostics for the specific 
device. 

? device error ON INPUT DEVICE DIRECTORY (Monitor. UPDAT) 
The specified error occurred while accessing tSe 
directory on the Input device specified in the last 
operator command, there may be problems with either 
the device or the media. Try running diagnostics 
for the device. 

dev'ce error ON OUTPUT DEVICE (Monitor. UPDAT. PATCH) 
The specified error occurred on the input device 
specified in the last operator command. If the 
error persists, the media or the hardware may be 
bad. Try running diagnostics for the specific 
device. 

device error ON OUTPUT DEVICE DIRECTORY (Monitor. UPOAT) 
The specified error occurred while accessing the 
directory on the output device specified in the last 
operator command. There may be problems with either 
the device or the media. Try running diagnostics 
for the device. 

oevlce error UHILE LOADING DRIVER FOR dev 
(Monitor. UPDAT. PATCH) 
The specified error occurred while the driver for 
the specified device was be'ng loaoed Into memory. 
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device error UHILE READING fileni 

(Hon i tor, UPOAT. PATCH) The specified error 
occ;.rred Mhile the specified file was being read. 

DEVICE FULL (Monitor, UPDAT) 

The capacity of the output device has been exceeded. 
For disk devices (random access), there are not 
enough physical blocks remaining to store the file. 
Any blocks allocated during the attempt to write the 
file are deallocated. For tape devices (sequential 
access), the physical end*of-tape mark was reached 
Nhtle the file was being written. In both cases, no 
file is created. Delete some existing files or use 
another medium. 

DIRECTORY FULL (Monitor, UPDAT) 

There are no remaining entries in the directory and 
the name of the file and other data cannot be 
entered. No file is created. Delete some existing 
files or use another medium. 

ENO-OF-MEDIUM (PATCH) 

Uhile reading a file, the end of the file was 
encountered before it was expected. 

ERR HLT (DRS) 

A halt-on-error has occurred. DRS is now back at 
command mode. Halt-on-error only occurs if operator 
has specified this mode with a flag to DRS. 

FILE ALREADY EXISTS (Monitor. PATCH) 

The name of the file specified for output matches 
that of a file that already exists on the output 
medium. Delete the old file or use a different 
ni 



' FILE NOT FOUND (PATCH) 
The specified input filename does not exist. 

FILE TOO BIG (PATCH) 

III inter nnn PC nnnnnn Ps nnnnnn (DRS) 

An unexpected Interrupt occurred through vector nnn. 
The Program Counter and Processor Status Uord at the 
time of the Interrupt are given. 

INPUT TABLE EMPTY (PATCH) 
The specified command cannot be executed because 
there are no entr'es In the input table. 
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? INPUT TABLE FULL (PATCH) 

Th« input table is full and cannot accept any more 
entries. 

INSUFF rCH (DRS) 
There ie not enough memory space to store table 
information for tne number of units that the user 
Nsnts to specify. 

INVAL SUTCH FOR CMND (DRS) 

Th« user specified a non-existent or non-appl ! cable 
snitch in the previous command. Refer to tne table 
of snitches Chapter 3. 

INVAL UNIT (DRS) 
The user specified a unit that does not exist. 

? INVALID ADDRESS (PATCH) 

An address given in the last command was not legal 
(possibly an odd number). Check the command and 
re-enter properly. 

? INVALID ADDRESS (UPDAT) 
There are three operations that can cause this 
error. One, when using the flOO command to modify a 
virtual location, the address of the location given 
was odd or not within the upper and lower core 
limits. Two, the address given in a LOCORE command 
was higher than the current ^igH core limit. And, 
three, the address given in a HICORE command was 
lower than the current low core limit. 

' INVALID COmAND (Moni tor, UPOAT. PATCH) 

You have entered a command that is not recognizable. 
Check the command (especially spelling) and re*enter 
properly. 

INVALID DEVICE (Monitor, UPDAT, PATCH) 

This error has a number of causes, depending on the 
command being used. For file related commands (DIR, 
COPY. ZERO. SAVE. SAVM. DEL. BOOT and EOT), one of 
the devices specified is not file-structured (like 
paper tape). For EOT. the device is a non-tape 
device. For COPY, the specified devices are not 
Identical types. 

INVALID FILENAME (Monitor. UPDAT. PATCH) 

You specified a filename in the previous command 
that was not In the proper format. 
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? INVALID MODULE NAME (PATCH) 
A DEC/Xll nodule name Nas incorrectly specified. 

? INVALID NUMBER (Monitor, UPDAT, PATCH) 

A number specified in the last coivMnand Nas not 
entered properlv. Possible problems are: not a 
number (e.g.* l2e4) or not proper radix (e.g.» 1292 
is not octal). 

? INVALID SWITCH (Monitor. UPDAT) 

The last command Nas entered Nith a SNitch that is 
not recognized by UPDAT, Re-enter the command 
properly. 

? LOGICAL DEVICE NOT ASSIGNED (Monitor, UPDAT) 

An attempt Nas made to use a logical unit number 
Nithout first assigning it to a device. (See ASG 
command. ) 

LOOKUP ERROR filnam (DRS) 
This error message actually comes from the XXDP 
monitor. If the file name is DRSXM.SYS or 
DRSSM.SYS. then the diaonostic being run requires 
the DRS. but the DRS file Is not on the system 
medium. Any other file name indicates that the 
diagnostic attempted to open a file that does not 
exist on the system medium. 

LOOP CHNG (DRS) 

The range of the loop changed Nhile looping on error 
Nas in progress. 

' MEMORY ERR AT LOCATION: xxxxxxxx (Monitor) 
A nonexistent memory or a memory parity error 
occurred at the location specified. If the type of 
error is detected that Nill also be reported. 

^?^MORY PARITY ERR AT LOCATION: xxxxxxxx 

MODULE NAMES NOT ALLOWED WITHOUT MAP FILE (PATCH) 
The operator attempted to specify a module name in 
the MOD command Nithout first loading the proper MAP 

file. 

MODJLE NAME NOT FOUND (PATCH) 

The specified module name does not exist Nithin the 
DEC/Xll runtime exerciser. 
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HiJCT BE EVEN (PATCH) 
The operator attenpted to specify an odd number as 
an address. 

MI/ST BE OCTAL (PATCH) 

The operator attempted to type a non-octal number. 

NEED NUMBER (PATCH) 

The operator omitted a numeric value from a command 
that expected one. 

NO DEVICE DEFAULTS (PATCH) 
Default device names are not allowed. 

NO IWIT (DRS) 
There are no active units. Either no units have 
been specified or all units have been dropped. 

NOT ENOUGH ROOM TO LOAD DRIVER (PATCH) 

The driver for the specified device will not fit 
into memory. 

NOT FOUND (UPDAT. PATCH) 

The file specified for input in the last command was 
not found on the device specified. 

NOT FOUND: XX. SYS (UPDAT) 

The driver for device "xx" was not found on the 
system medium. This message is printed by the 
monitor driver which is used to load device drivers 
for UPDAT. Transfer the required driver file to the 
system medium. 

NPr FOUND: filnam (Monitor) 
The specified file was not found by the monitor. 
The monitor can only read files that are on the 
system medium unless a specific device is specified. 

NOT FOUND: xx.SYS (Monitor) 
The driver for device "xx" was not found on the 
system medium. Transfer the required drive file 
(XX.SYS) to the system medium. 

NOT HALTED (DRS) 

The user attempted to enter a PROCEED command when 
the DRS had not executed a "halt-on-error" sequence. 

NJMBER TOO BIG (PATCH) 
The value typed was too large for its intended 
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purpose . 

? OPTION riODULE NAME NOT FOUND (PATCH) 
Th€ specified option module does not exist. 

? OVERFLOH (Monitor, UPDAT) 

An stteupt Mas made to load too large a program into 
the program buffer. 

PASS ABORTED FOR THIS UNIT (DRS) 

Test I no Mas prematurely ended for the current unit 
being tested. There is usually an error message 
from the diagnostic given prior to this message. 
Refer to the specific diagnostic documentation for 
the reason that the unit may have been aborted. 

? READ ERROR (Monitor) 
A device error occured Mhile reading. Retry the 
operation. 

? SPECIFY DEVICE (Monitor. UPDAT. PATCH) 

The last command specified does not alloM the use of 
default device specifications. Re-enter the command 
Mith the deviceCs) explicitly specified. 

? SYNTAX ERROR (Monitor. UPDAT, 

PATCH) 

The last command Mas entered improperly. Re-enter 
the command properly. 



TRAP ERR AT: f\f\f%f%f\f\ (DRS) 

An unrecognized TRAP instruction Mas executed. The 
TRAP instruction is used to cow wu nicate betMeen the 
diagnostic and DRS. This error should never occur 
in field operation. Please report the problem if it 
does. 

TST TOO BIG (DRS) 

The user specified a test number that is larger than 
the number of tests in the diagnostic program being 
run. 

tJNEXPECTED ENO-OF-FILE (Monitor. UPDAT. PATCH) 

The logical end of a file Mas encountered before it 
Mas expected. The file in question is corrupt. 

JNEXPECTED INTERRUPT FROM: xxxxxxxx (Monitor) 
An unexpected interrupt occurred from the indicated 
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location. 

? UW7E ERR (Monitor) 

A dav ic« error occurred while writing. Retry the 
operation. If the error as reported from the driver 
contains additional information this will also be 
reported by appending this information to the end of 
the above report. Some errors that be detected and 
easily corrected by the user would be the case where 
the device is write locked or does not have a write 
ring in stalled. 

^?*IKlTE ERR - DKO: URITE LOCKED 



7UR0NG MAP FILE FOR MONITOR TYPE (PATCH) 

The MAP file in memory does not have the specified 
monitor type. 



N15 

SEQ 0195 



B16 

Pege Index -1 



INDEX 



XTECO. 7-6 
Abbreviations 

xn coMtands. 2-16 
ACT. 6-1 
Add 

DRS. 3-7 
AOfl. 3-24 
ASG 

UPOAT. 46 

Batch 

conditionals. 8-4 

Monitor coMnands. 8-2 
Batch control. 8-1 
batch control handler. 2-2 
BOe. 3-24 
BOOT 

PATCH. 5-4 

UPDAT, 4-7 
Boot 

XH, 2.17, 2-28 



x-'ECO. 7-^ 
Cha'n 
XH. 2-18 

chain 

SH. 2-7 
Characters 

control, 1-4 

special. 1-3 
C^EAB 

PA^CH. 5-5 
* P 

■"jPOAT. 4-8 
CoMtand Hodif ers 
^ DPS, 3-3 

DOS, " 



3-5 



aoo. 



continue, 3-8 
display. 3-9 
drop. 5-10 
flags. 3-11 
proceed, 3-12 
restart. 3-15 
start, 3-16 
time. 3-18 
zflags. 3-19 

SH 

chain. 2-7 
directory, 2-8 
enable, ^-9 
help. 2-10 
load. 2-11 
run. 2-12 
start. 2-13 
Suflmary 

"Onitor, 2-6 

XM 

abbreviations. 2-16 

boot. 2-17, 2-28 

chain. 2-18 

copy. 2-19 

date. 2-20 

delete. 2-21 

directory, 2-22 

enable. 1-23 

help, 2-24 

initialize. 2-25 

load. 2-26. 2-31 

print. 2-27 

run. 2-29 

set. 2-30 

type. 2-32 
Compatibility 

with DPS. 3-1 
Conditionals. 8-4 
Console commands. 3-2 
console terminal driver, 2 2 
Continue 



VXDP LMr s Guldt Index 



OfiS. 3-8 
Control 

ftc^. 6-1 . , 

Control characters. 1 4 
Convent !ona 

interface. 1-3 



temlnal 

COPV 

^ UPOAT. 4. 

2-19 
CPU*. 2-2 



9 



-8 



files. 5-19 



XTECO. 
Date 

XH. 2-20 
0€C/XC11 wop 

DEL 

UPDAT. 4- 

Delete 

XM. 2-21 
OEPO. 4-3 
Dev'ce 

dr'ver*. 
D' agnostic 

rcqu'rcMentS, 

r«str'ctIons. _ _ , 

D*a9>ost'c Runtinte Services. 3-1 
Olognostlc rynt;«e serv'ces. 1-2 



-11 



C-1 



2-2 
2-3 



0 

DC 



UPQAT. 4-12 
roc tor V 
XH. 2-22 
roctory 
Sf*. 2-§ 
soloy 
0«S. 3 



JPOA-f. 
DRIVER 
JPDAT. 



9 

4-14 

4-16 



Dr ,^«r$ 

loaoatole dev'ce. 
sjooorteo, I 1 



Drop 

DPS. 3-10 
DRS. 1-2. 3-1 

Concepts. 3-2 

orror format. 3-4 

Start-up. 3-2 
DRS CoMtands 

in batch. 8-3 
ORSSM. 3-1 
DRSXM. 3-1 
DUMP 

UPOAT, 4-17 

EDIT command. 7-3 
Editing 

start-up. 7-3 
Enable 

XM. 2-23 
enable 

SM. 2-9 
/EOP. 3-20 
EQP 

SMitch. 3-20 
EOT 

UPOAT. 4-18 
EVL. 3-25 
EX 

XTECO. 7-9 
EXIT 

PATCH. 5-6 

UPOAT. 4-19 

XTECO. 7-26 
Extensions 

spcc'al. 1-5 

FILE 

JPOAT, 4-24 
Pile conventions, 1- 
Files 

modif icat'on, 4-2 

required, E-l 
/FLAGS. 3-21 
Flags. 3-23 

ADR. 3-24 

BOE. 3-24 



C16 

Page Index -2 



bEQ 0197 



XXDP ^scr s Guide Index 



D16 

Page Index -3 



SEQ 0198 



OAS. 3-11 

E^L. 3 ^5 

HOC. 3-25 

IBE. 3-25 

lOfi. 3-26 

IE«. 3-26 

:s«. S-26 

lt€, 3-26 

wOE. 3-26 

^OT, 3-2" 

PNT. 5-2' 

Pai, 3-27 
•M^tcK. 3-21 

U*M. 5-27 

PATCH. 5-7 
GCTP 

PATCH, 5-8 
GOTO. 8-5 

oaraMctcr tables. 3-3 
reou>t««nts, 2-3 

Help 

XH. 2-24 
help 

SM. 2-10 
HICORE 

UPDAT. 4-20 
HOE. 3-25 



X'ECO. 7-21 
IBE. 3-25 
lOR. 3-26 
lEfi. 3-26 
IP. 8-4 
IPERR. 8-4 
:FuHD. 8-4 
In'tialize 

XM. 2-25 
:SP. 3-26 
:/E. 3-26 



XTECO. 7-11 



XTECO. 7-12 
KILL 

PATCH. 5-9 



XTECO. 7-14 
LIST 

SETUP. 6-2 
LOAD 

UPOAT. 4-21 
Load 

XM, 2-26. 2-31 
load 

sri. 2-11 
Loadable device drivers. 1-3 
LOCORE 

UPDAT. 4-22 
LOE. 3-26 
LOT. 3-27 

MsD files 

DEC/XU, 5-19 
Memory requirements 

SETUP. 6-1 
MOO 

PATCH. 5-10 

UPOAT. 4-23 
Monitor. 1-1 

coMnand summary. 2-6 

Command syntax. 2-15 

components. 2-1 

size. 2-1 

SM 

chain. 2-7 
directory, 2-8 
enable. 2-9 
help. 2-10 
load. 2-11 
run, 2-12 
start. 2-13 

XM 



XXOP Lscr s Guide Index 



E16 

Page Index -4 



SEQ 0199 



boot, 2-17. 2-28 

Chan. 2-18 

copy. 2-19 

date. 2-20 

delete. 2-21 

d rectory. 2-22 

enable. 2-23 

Kelp. 2-24 
ntlallie. 2-25 

lobd. 2-26. 2-31 

print. 2-27 

rjn. 2-29 

set. 2-30 

type. 2-32 
'^'tor coamands 

n batch. 8-2 
•«on"tor services handler. 2-2 



XTECC. 7-15 

operator Interface handler. 2-2 

/PASS. 3-21 
Pass. 3-3 

swtch. 3-21 
PATCH 

BOOT. 5-4 

C;.EAR. 5-5 

coMand suanary. 5-2 

EXIT. 5-6 

GE^H. 5-' 

GETP. 5-8 

"III. 5-9 

HOD. 5-10 

operat'on. 5-2 

PATCH. 5-14 

SAi/P. 5-17 

'•PE. 5-18 
Patch. 5-1 
PIP 

JPOAT. 4-24 
PS". 2-27 
POI. 3-27 



UPOAT. 4-27 

XTECO. 7-25 
Print 

XM. 2-27 
Proceed 

DRS. 3-12 

READ 

UPOAT. 4-28 
read-Nrlte device driver, 2-2 
REN 

UPDA7. 4-29 
Requirements 

diagnostic. 2-2 

bardMare. 2-3 

menory 

SETUP. 6-1 
Restart 

DRS. 3-15 
Restrictions 

diagnostic. 2-3 
Run 

SM. 2-12 

XM. 2-29 



XTECO. 7-16 
SAVP 

PATCH. 5-17 
Services 

diagnostic runtiac, 1-2 
Set 

xri. 2-30 
SETUP. 6-1 

LIST. 6-2 

SETUP. 6-2 
SLIDE. 6-1 
SH 

chain. 2-7 
directory. 2-8 
enable, i-9 
help. 2-10 
load. 2-11 
run, 2-12 
Start. 2-13 



XXDP sJ%%r 9 Guidt Index 



F16 

Pagt Index -5 



'>E0 0200 



SM •or» to»'. 2 1 
D*r«Mctcr tables. 3-3 

Spec •! cHsractcr'S. 1-3 
St»rt 

WS. 3-16 
Start up 

0«S. 3-2 

process. 2 4 
Start up procedure. 2-3 
Start/SH, 2-13 
Sw'tcKes 

cowto'n'nQ. 3-23 

WS. 3-3 

EOP. 3-20 

flags. 3-21 

pass. 3-21 

Test. 3-22 

urts. 3-22 
Sy*>tax 

tn coMands. 2-15 
Systc* 

start-up. 2-3 

start-up process. 2-4 



tlECO, 7-18 
''ables 

building. 3-27 

HardMsrc parpMcter. 3-3 

•o^tMarc paraMcter. 3-3 
'ECC coMiand. 7-3 
''erainal interface 

conventions. 1-3 
Teat. 3-4 
/TESTS. 3-22 
Teats 

a«'tch. 3-22 
"^EXT coMiand. 7-3 
"HEN. 8-4 

0»S. 3-18 

PA'CH. 5-18 
JPO*'. 4-30 



^^?t1. 2-32 
TYPE.XTECO. 7-25 

U*M. 3-27 
/UNITS, 3-22 
Units. 3-3 

switch. 3-22 
UPOAT, 4-1 

ASG. 4-6 

BOOT. 4-7 

CLR. 4-8 

COPY. 4-9 

DEL. 4-11 

DIR. 4-12 

00. 4-14 

DRIVER. 4-16 

DUMP. 4-17 

EOT. 4-18 

EXIT. 4-19 

FILE. 4-24 

HICORE. 4-20 

LOAD. 4-21 

LOCORE. 4-22 

MOD. 4-23 

PIP. 4-24 

PRINT. 4-27 

READ. 4-28 

REN. 4-29 

starting. 4-1 

TYPE. 4-30 

XFR, 4-31 

ZERO. 4-10. 4-32 
Utility prograM. 1-2 
UUT. 5-3 

Wildcards 

in file specifications. 1-4 

XFR 

UPDAT. 4-31 

XM 

boot. 2-17. 2-28 

chain. 2-18 

Coamand syntax. 2-15 



^XOP js«r s Guldt Index 



Page Ind«x-6 



copy. 2-19 

0»t«. 2 20 

i«l«t«. 2-21 

d'recto^v, 2-22 

enable. 2-23 

help. 2-24 

"n'tlellze, 2 25 

load. 2-26. 2 31 

pr nt. 2-2"* 

rvjr. 2-29 

set. 2 30 

type. 2-32 
XM Mon'tor. 2-1 
i(TECO, 7-1 

A. 7-6 

C. 7-7 

COMpnd Sumnsry. 7-4 
concepts. 7-1 
0. •'-8 
EX. 7-9 
EXIT. 7-26 

COS OF WNM.] 



I. 7-21 
J. 7-11 
K. 7-12 
L, 7-14 
N. 7-15 
PRINT. 7-25 
S. 7-16 
starting, 7-3 
T. 7-18 
TYPE. 7-25 
ZJ. 7-20 
XXOP 

*onttor, E-1 
required. E-1 



ZERO 

UPOAT. 4-10. 4-32 
Zflaos 
DR5. 3-19 



ZJ 



XTECO. 7-20 



